New procedures for committing to HistoryAtState repositories #31
Description
An important heads up to all @HistoryAtState/editors and @HistoryAtState/existsolutions folks:
This week I made some changes to our common oXygen configuration file (hsg-project.xpr) to ensure that our documents are formatted consistently. This will help in several ways, most notably, ensuring that our commits are atomic and reveal only the changes we made, not other incidental changes. As a result, I would like to request that everyone perform the "Fetch updates for all repositories" command from oXygen's External Tools menu to update your oXygen configuration file (letting me know if you see any errors in the console log as the updates are fetched), then quit and restart oXygen to ensure the new configuration is active.
Then, henceforth, please follow the following new procedure for committing your work (step 2 is the change):
- Make any changes to your document(s).
- Click the "Format and Indent" button in oXygen's toolbar (also accessible via the "Source" menu under "Document" > "Format and Indent", and save the document.
- Commit the document.
If you have made changes to many files, you can apply "Format and Indent" on multiple files, doing the following instead of step 2 above):
2a. Format and indent all opened files: In the "Tools" menu select "Format and Indent files...", and change the "Scope" to "All opened files".
2b. Format and indent only certain files: In the "Project" pane, select the files, then right-click on one of the selected files and select "Format and Indent Files..." from the contextual menu. A dialog win
2c. Format and indent an entire folder's worth of documents: In the "Project" pane, right-click on a folder and select "Format and Indent Files..." from the contextual menu.
In the dialog box that appears after 2a, 2b, or 2c, be sure that the checkbox for "Make backup files with extension" is unchecked. Select OK to begin the operation. Here is what this dialog box looks like after 2a:
