The following steps detail the process of creating and updating edX Help Center documentation in Zendesk Guide.

Note: The edX Learner Guide is the only help content maintained outside of majority of technical documentation is authored and maintained via Sphinx and Read the Docs in Zendesk. See the table at 3. Locate and Edit Documentation for file locations for various documentation products.

Before you begin, ensure that you have the right permissions to author in Zendesk Guide.The following procedures can be used when

Procedures:

• Creating a new help article
• Updating an existing help article and publishing changes immediately
• Updating an existing help article with future changes
• Publishing a draft article

...

1. Log in to Zendesk.
2. In the upper right corner, select  , then select Guide. The Themes page appears.
3. In the upper left corner, select Add, then select Article.
4. In the left hand pane, enter the article title and content. Use the appropriate formatting options for the article type. For information on formatting, see Style guidelines for help articles in Guide, in the edX brand. You must be logged in to Zendesk to view this article.
5. In the right hand pane, enter the following:
   1. Under Publish in section, select the category and section that the article will appear in. 
   2.  Deselect the checkbox for Open for comments. Note: This is selected by default. This allows commenting on articles that we are presently not staffed to moderate. 
   3. If desired, select the checkbox for Promote article. Promoted articles appear at the top of any menus and article lists and typically address common questions. Promoting articles helps surface content that may otherwise be lost in alphabetical lists or other section hierarchies.
6. Select Save. This saves, saves but does not publish, your article your article, and changes the state to Work in Progress.
7. Verify and test the article
in both the current and in-development themes. Note that testing the documentation is required. 
8. Test the current theme: On the article editor page, select Show in Help Center to launch the article in the current theme; this shows how the article will be formatted and appear when published and live in the help center.
Test the in-development theme: On the left of the screen, select Customize design. Under Custom themes, select View theme. This will load the in-development theme on any currently opened help articles, as well as any you open after loading the theme. Note that this does not publish the theme, or change any formatting to the currently live help center site.
Note: Article styling, especially if you've copied in content from another source or document, will not always display as expected. You may have to select Source code Image Removed , located in the editor toolbar, to adjust the formatting, or reformat the text within the editor window.
9. by selecting Preview in the righthand column. This launches the article in the current theme and shows how the article appears live in the help center. To ensure formatting consistency, testing the documentation is required. 
10. When the styling and content have been tested and revised if necessary, select the dropdown arrow next to Save and select Publish.
    This automatically publishes the article and adds it to the live help center in the category and section that you set.

...

1. Log in to Zendesk. 
2. On the left, select Manage articles. 
3. Locate the help center article that needs updating. You can do this by using entering words from the article title in the search field, and/or by filtering to control the articles that you seeusing filters in the Filters dropdown, and sorting by selecting an article state (Published, Ready for review, Work in progress, etc.) from the lefthand column.
4. Make the needed updates. For information on formatting, see Style guidelines for help articles in Guide.
5. Verify and test the article by selecting Show in Help Center Preview in the righthand column. This launches the article in the current theme and shows how the article appears live in the help center.
   Note that article styling, especially if you've copied in content from another source or document, will not always display as expected. You may have to select Source code ( ), located in the editor toolbar, to adjust the formatting, or reformat the text within the editor window. Note that To ensure consistent formatting, testing the documentation is required.
6. Select Save to save your changes. This will set the article workflow at as Work in Progress. The current and unchanged article is live, and the changes to the article are not yet visible.
7. A Flag translations dialog box appears. Select the toggle to flag the article, so that it can be added to the Flagged translations list (currently to track needed Spanish article updates) and marked as out of sync with the English source help article.
8. Select the dropdown arrow next to Save and select Publish to publish your changes.

...

There may be times when you need to update an existing article but do not want to publish the changes immediately - for instance, if you are documenting a change to an existing feature or option, and need to wait to publish the article updates until the changes are live in the softwarecourse or platform. 

1. Log in to Zendesk. 
2. On the left, select Manage articles. 
3. Locate the help center article that needs updating. You can do this by using entering words from the article title in the search field, using filters in the Filters dropdown, and /or by filtering to control the articles that you see.
4. Copy the article title and article content. You will be pasting this into a new article, as today Zendesk does not offer a way to more formally control versions. 
5. In the upper left corner, select Add, then select Article (or category or section). 
6. Paste in the article title, and add the word DRAFT at the end of the title. Paste in the article contents. For sorting by selecting an article state (Published, Ready for review, Work in progress, etc.) from the lefthand column.
7. Make the needed updates. For information on formatting, see Style guidelines for help articles in Guide.
8. Select Save to save your changes.
9. Verify and test the article by selecting Show in Help Center Preview in the righthand column. This launches the article in the current theme and shows how the article will appears once it is live in the help center.
   Note that article styling, especially if you've copied in content from another source or document, will not always display as expected. You may have to select Source code Image Removed  , located in the editor toolbar, to adjust the formatting, or reformat the text within the editor window. Note that testing the documentation is required.
10. When the feature releases and you want to publish the help article, locate the current article via title, which will show both the live and draft versions.
11. Open the draft article, and copy all of the article contents. Overwrite the live article by pasting the draft content into the live article.
12. Select  Save  to save your changes . This will set and update the article workflow at status in Zendesk to Work in Progress. The  The current and unchanged article is live, and the changes to the article are not yet visible.
13. Verify and test the article by selecting Show in Help Center. Fix any formatting issues, then save and preview the article again, until you are satisfied with the output. Note that saving to a live article publishes the updates automatically, so you need to fix formatting issues immediately.
14. Delete the draft when you have updated and the live article and no longer need it.

To publish a draft article (or category or section)

1. Log in to Zendesk.
2. On the left, select Manage articles. 
3. Under Lists, select Drafts. 
4. Locate your draft article (or category or section). You can do this by using the search field, and/or by filtering to control the articles that you see.
5. Verify and test the article by selecting Show in Help Center. This launches the article in the current theme and shows how the article will appear when published and live in the help center.
   Note that article styling, especially if you've copied in content from another source or document, will not always display as expected. You may have to select Source code Image Removed , located in the editor toolbar, to adjust the formatting, or reformat the text within the editor window. Note that testing the documentation is required.
6.  Once the styling and content have been tested, select the When the feature releases and you want to publish the help article, locate the current article via title. You can also find the article via the Work in Progress list.
7. Select the dropdown arrow next to Save and select Publish . 
   This automatically publishes the article and adds it to the live help center in the category and section that you set when you first created the draftto publish your changes.

Additional Information

• About Workflow States in Team Publishing
• edX GIT Repository
• GitHub edx-documentation repo
• GIT Cheat Sheet
• Intro to Git on Engineering Wiki