Here's some information that might be helpful while working on a Docs PR:
-
Development - This short guide describes how to get this app running on your local machine.
-
Content markup reference - All of our content is written in GitHub-flavored Markdown, with some additional enhancements.
-
Content style guide for GitHub Docs - This guide covers GitHub-specific information about how we style our content and images. It also links to the resources we use for general style guidelines.
-
Content model and content templates - The content model describes the purpose of each type of content we use in GitHub Docs and how to write for each type. The templates allow you to quickly get started with new articles.
-
Reusables - We use reusables to help us keep content up to date. Instead of writing the same long string of information in several articles, we create a reusable, then call it from the individual articles.
-
Variables - We use variables the same way we use reusables. Variables are for short strings of reusable text.
-
Liquid - We use liquid helpers to create different versions of our content.
-
Scripts - The scripts directory is the home for all of the scripts you can run locally.
-
Tests - We use tests to ensure content will render correctly on the site. Tests run automatically in your PR, and sometimes it's also helpful to run them locally.