Creating and configuring repositories

Overview

Depending on product release schedules and workflows of various authoring teams across Adobe, you might need to create additional repositories to host various types of documentation that you don’t want to include in the public documentation yet, such as Beta documentation that should only be accessible to a select number of customers.

This article explains how to create a new repository, configure a new Jenkins build job to push the content live, and finally, how to activate the new repository on experienceleague.adobe.com.

For background information, see User guide setup.

Step 1. Create a New Repository

Here’s how to create a new repository:

1. Go to AdobeDocs GitHub and log in with your LDAP credentials.

2. Click New.

3. Enter the name of your new repository in the Repository name field.

   Use the <repo-name>.en format, such as campaign-classic.en. Use lower-case letters and hyphens. Add the .en suffix to allow for localization.

   If you’re not sure what the name of your repo should be, log a JIRA bug (project: UGP) and assign it to Bob Bringhurst. Bob will consult with the Tech Marketing team.

4. Click Create repository.

   

Now you can clone your repository locally and start working in it. See Git Setup for details on how to clone your repository locally.

Step 2. Add Content

1. Copy files from a different repo. We like to use the template.en repo as a template for copying files.

1. Edit the metadata.md and TOC.md files for the new repo. Include the following:

   • product (for Omega analytics)
   • solution (for search filtering)
   • type (for search filtering)
   • git-repo (for “Edit this page” and “Log an issue”)
   • index (turn search on or off)
   • user-guide-title (displayed on article page)
   • user-guide-description (can be used in landing page description)
   • breadcrumb-title (optional to add shorter guide title in breadcrumb)

   See Metadata and User Guide Setup for details.

2. Add UICONTROL and DNL tags for localization.

   See Localization Best Practices.

Step 3. File a JIRA ticket

1. Log a JIRA ticket (project = UGP; component = Authoring) with a title such as “Add repo to EXL pipeline,” and assign it to Bob Bringhurst.
2. Indicate the repo name and which landing page it should be added to.
3. If you’re moving content from a different repo, let Bob know. He’ll help you set up redirects.
4. Let Bob know if and when you’re ready to publish content.
5. Let Bob know about landing page updates.

Bob (or another SCCM member) will do the following:

• Check the repo for completeness.
• Give Git rights to team or individual.
• Add the repo to the pipeline. Steps below
• Create a public git mirror.
• Add the repo to the mirror sync list. Steps below
• Add the repo to the Experience League publishing pipeline (via Airtable) and notify the Localization team.
• (When repo is ready) Select the Publish flag to allow content to be activated.
• Configure the repo in Jenkins for activation.
• Add repo to activate-exl list.
• Add redirects (if necessary).

Step 4. Validate and activate content

1. Make sure your content is ready to publish. See New Project Publication Checklist.
2. Make sure your content passes validation.
3. Activate content
4. If you’ve moved content from a different repo, submit redirects.

Repo configuration tasks (Admin)

• [ ] Make sure repo is configured properly.

  • [ ] All processing files in root folder.
  • [ ] Valid structure for guides. TOC and home page.
  • [ ] Metadata in metadata.md and TOC.md files: git-repo, user-guide-description, breadcrumb-name, solution, type, and so on.

• [ ] Connect repo to EXL.

• [ ] Add English repo to Airtable.

• [ ] Add Loc repos to Airtable.

• [ ] Create Github mirror.

• [ ] Make sure repo auto-syncs.

• [ ] Add repo to activate-exl configuration.

• [ ] Select Publish in Airtable when ready.

• [ ] Add link to landing pages.

• [ ] Configure for Acrolinx (when available).

Connect repo to EXL

1. Go to Jenkins and log in with your LDAP credentials.

2. Open the GenerateExlJob job.

3. In the left side menu, click Build with Parameters.

4. Enter the root name of the repository that you created at Step 1 in the SOLUTION field.

5. Enter the repository language (such as en) in the LANG field.

6. Click Build.

   

7. Open the exl job and make sure that it’s enabled (it should be enabled by default).

Stage is not yet available. Once it’s available, you’ll want to enable exl-stg as well to work with the staging branch.

Configure auto-sync (admin)

1. In Git, create webhook:

   https://adobedocs.ci.corp.adobe.com/github-webhook/

2. application/json

3. SSL verification ENABLE

4. Permissions:

   • Issue comments
   • Pull requests
   • Pushes