Best practices and tips

Editing files

Before making any changes/edits, go to GH Desktop and ensure your local repository is up to date: click Fetch origin and click Pull origin if you see that there are changes that you have not pulled (updated) in your local repository. This is indicated by a small notification dot with the number of upcoming changes.

To edit a topic, click on a file in the left navigation pane to open the file contents in the right editing pane. After finishing your updates, click Ctrl-S or File > Save to save your changes.

How to comment out text:  Enclose text with <!--xxx-->, where xxx is the text.

About DCO

"...technically every commit should be signed off as that is the idea behind DCO automation".

You can enable the DCO signoff tool https://github.com/coderanger/dco on PC if you don't want to copy/paste your signature in every commit manually. This works when committing via command-line or Github Desktop.

If you make commits directly in the GitHub UI, you still must paste your signature into the commit.

About branch and repo management

Periodically clean up unused branches and repos that you own.

Doc staging branch

https://github.com/zowe/docs-site/tree/docs-staging

• Hosts draft information for the next release. All content for the next new release should go to this branch instead of master branch before delivery.
• Remember to add release notes when a new feature or enhancement etc is made that has impact on user behavior
• Need to continuously sync updates from the master branch. You can understand the relationship between master branch and doc-staging as follows: docs-staging = master + new release content
• Copy over files to the master branch before delivery
• Can run local docs site to verify updates and do review. Need to educate your reviewer.