Skip to content

Latest commit

 

History

History
133 lines (74 loc) · 5.74 KB

edit-existing-using-github.md

File metadata and controls

133 lines (74 loc) · 5.74 KB
title description author ms.author ms.date
Edit an existing Windows Server article using GitHub and Visual Studio Code
How to edit an existing Windows Server-related articles, using GitHub and Visual Studio Code, as a Microsoft employee.
eross-msft
lizross
05/06/2019

Edit an existing Windows Server article using GitHub and Visual Studio Code

As a Microsoft employee, you can follow these instructions to edit an existing article and to create a new pull request for approval and publishing.

You must still create a new branch for edits, but you don’t have to create a new .md file. Instead, you can just open Visual Studio Code and browse to the location of the folder or file. After you find the file you want to update, make your changes, preview your text, and then commit your changes.

Note

For information about how to create and set up your GitHub account, set up two-factor verification, and install and configure all the necessary tools, along with how to set up your own version of the repo, see the Create new Windows Server articles using GitHub and Visual Studio Code article.

Switch your repo and create a new branch

Follow these steps to edit an existing article.

Create a new branch and locate the file you want to update

Before you can start to work on your content, you must first change to the windowsserverdocs-pr repo and then locate the article you want to update.

To create a new branch in Git Bash

  • Open Git Bash and type the commands (one at a time):

    cd windowsserverdocs-pr

git checkout –B <name_of_your_new_branch>

git push origin <name_of_your_new_branch>

    [!Note] We highly recommend naming your branch something obvious and unique so you can find it again later.

    After the commands finish, you’ll be in your new branch and ready to edit your file.

To locate your article and make your edits

  1. Open Visual Studio Code and go to File, select Open folder, and then go to the GitHub location of the folder that has the article you want to edit.

  2. From the Explorer pane, select the file.

  3. Update the information on the page, and then select File > Save.

Preview your text

After you update the text, you must preview your changes to make sure they appear correctly.

To preview your text

  1. In Visual Studio Code, select either of the Preview buttons from the upper right-hand corner.

    preview button icon: Switches to a full-page preview of your content.

    preview button icon: Opens the preview page next to your working page, side-by-side.

  2. Make sure your article looks how you expect it to look.

    After you're sure it looks right, you can commit your changes and create a pull request for publication.

Commit your changes

After you make sure your text looks right, you can commit your changes to your local version of your repo.

To commit your changes

  • Open Git Bash and type the commands (one at a time, removing the OPTIONAL tags):

    OPTIONAL: git status

git add .

git commit -m “public comment about what change is”

OPTIONAL: git pull upstream master

git push origin <name_of_your_new_branch>

    The optional git status command shows you which files have been modified as part of this commit. The optional git pull upstream master pulls down the latest content changes from the MicrosoftDocs master branch, syncing your local content with the primary master content. This helps to show you any potential merge conflicts ahead of time so you can fix them before you get to the PR stage.

Submit a pull request for review and publication

After you've completed your updates, you must get approval from your writer (allow some time for this) for publication.

To submit your pull request

  1. Go to https://github.com/MicrosoftDocs/windowsserverdocs-pr and select the Pull requests tab.

  2. In the Reviewers area of the right pane, select the gear icon, and then enter the windowsservercontent alias for review.

    A member of the windowsservercontent alias will review your changes or add comments about things that must be changed before merging can happen.

  3. Type #sign-off into the comments so that the reviewers know you’re handing off for both review and publishing. The #sign-off comment:

    • Updates the label for your pull request from do-not-merge to ready-to merge.

    • Lets the alias and writers know that you're ready to have your content reviewed.

    • Lets the admins know that after approval, your content is ready go live.

    [!Important] After you add the #sign-off comment, a member of the windowsservercontent team will review the text and push it to master so it will go out with the next scheduled publish to live (10:30am and 3:30pm weekdays).

    If you don’t add #sign-off as a final comment to your PR, your content will remain in the queue without being pushed to Master and ultimately to Live.

Related information

For more information about GitHub and the markdown language, see:

Git concepts

Markdown