Git/Visual Studio Code Setup

Welcome, Adobe writers. If you’re new to the GitHub workflow, see these articles:

Sign in to Git Corp

If you haven’t already set up your tools:

  1. Sign in to VPN (GlobalProtect).

  2. Sign in to Git AdobeDocs.

    Use your LDAP account to sign in. If this is the first time you have signed in to, an Enterprise GitHub account is created for you.

    Note that this Adobe Enterprise account is different from a personal account you may have created, even if you used your Adobe email address to sign up for Git Corp and are two separate systems.

  3. Ask Bob (bbringhu) or another Org Owner to give you access to any repo you’ll be working on.

    By default, new members have Read access. You’ll want Write or Admin access for any repo in which you’ll need to publish content.

Install tools

  1. Decide which Git client and Markdown editor you want to use.

    Most of us use GitHub Desktop for the client and Visual Studio Code for the editor.

    Both are free. Some people prefer using SourceTree or command line tools for the client. That’s fine.

  2. Sign in to GitHub Desktop (if you’re using it as a client).

    Make sure you’re signed in to VPN or AdobeCorp. In GitHub Desktop, go into Preferences > Accounts and specify your GitHub Enterprise Server user name and password. Use your Adobe LDAP info.

    You must be signed in to Adobe Corp or VPN to use the GitHub Enterprise Server.

  3. (Recommended) Install Git on your computer. (On a Mac, the Homebrew option works well.)

    Installing Git improves the communication between Visual Studio Code and Git/GitHub Desktop.

  4. Customize Visual Studio Code (if you’re using it as an editor).

  5. Become familiar with Adobe Markdown syntax.

  6. Continue to learn Git.

  7. If you want a demo or if you have questions, feel free to reach out to Bob, Blake, or Alva. We’re available through Slack and email.

Clone a repo

Cloning a repository lets you work on files locally. These steps assume you are using GitHub Desktop as a client. If you’re using a different GitHub client, adjust the steps accordingly.

You only need to clone a repo once. Before you edit the cloned files, make sure your local clone is in sync with the server.

  1. Go to the repository’s page in your browser and click the Clone or download button on the right side, and then click Open in Desktop.

    Clone image

  2. Click Allow to open GitHub Desktop.

  3. Specify the location of the cloned files (the default is a “GitHub” folder in your Documents folder).

    clone location image

  4. Click Clone.

  5. In GitHub Desktop, click Fetch Origin to pull the files down from the server to your hard drive.

    github desktop image

  6. Open the Markdown files in your editor of choice, and save the Markdown files. Any changes you make to the cloned files are listed in GitHub Desktop.


You only need to clone a repo one time. However, before you go back to work on your local clone, make sure that you “fetch” content from the server sync your local files with the server files.

Obtain access rights

If you need rights to merge pull requests or perform related tasks in your repo, contact the lead writer or Bob.

Turn on Git notifications

Each repo on AdobeDocs should have both an Enterprise version available only to Adobe users and a public mirror for anyone outside the company. Keep in mind that notification settings for these two Git areas ( and are different and require different log-in accounts and separate configurations.

You can enable notifications so that you get an email message whenever anyone logs an issue or submits a pull request for the public docs on

  1. Go to your repo on Git Corp or GitHub.
  2. From the Watch (or Unwatch) pull-down menu, choose Watching to receive notifications.

watch menu image

Change Git settings for repo (lead writer/admin)

By default, when you create an AdobeDocs repo in Git Corp, anyone who has access to the repo can commit changes directly to the main branch without waiting for validation or review. You might want to change these settings to require validation to pass.

  1. Make sure that you have admin rights to your repo. Contact the SSE team if necessary.

  2. Open your repo on and click the Settings tab.

  3. Click Branches in the left rail.

  4. Click Add Rule if there is not an existing rule for the main branch. (Click Edit if there’s already a rule for main.)

    If you’re creating a rule, specify the branch name such as master or staging in the Branch name pattern field.

  5. Specify the branch rules.

    rule settings

    • Select Require pull request reviews before merging if you want someone to acknowledge approval before a PR is merged. (Writers usually choose not to select this option.)

    • Select Require status checks to pass before merging and specify Validation (recommended). This requires the pull request to pass Jenkins validation before it can be merged to master.

    • Select Include Administrators if you want everyone, including admins to wait for validation to succeed. (Writers usually choose not to select this option.)

    • Select Restrict who can push to matching branches (recommended) and specify the members of your team, if anyone, who can push directory to master. When this option is selected, only the specified team members can commit directly to master. Everyone else needs to submit a pull request from a branch.


      When you restrict who can push directly to master, writers can get stuck in GitHub Desktop when they accidently attempt to commit the changes to the main branch instead of a different branch. When this happens, have an admin go change settings to allow the changes to go through, and then change the settings back. (There’s probably a better way to handle this in GitHub Desktop, but I haven’t figured it out…)

On this page