Writing for GitHub Docs - GitHub Enterprise Server 3.20 Docs
Skip to main content Skip to content Collapse sidebar Expand sidebar Writing for GitHub Docs Learn about writing for GitHub Docs. Best practices for GitHub Docs Follow these best practices to create documentation that's user-friendly and easy to understand. About GitHub's documentation philosophy Our documentation philosophy guides what content we create and how we create it. About GitHub's documentation fundamentals All content published on GitHub Docs must meet these fundamental requirements.
Content design principles We share these principles to design and create the best content for people who use GitHub. Writing content to be translated Our documentation is translated into multiple languages. How we approach writing the English language documentation can greatly improve the quality of those translations. Making content findable in search Follow these SEO best practices to help users find GitHub documentation using search engines.
Versioning documentation GitHub Docs uses YAML frontmatter and liquid operators to support multiple versions of GitHub with a single-source approach. Using Markdown and Liquid in GitHub Docs You can use Markdown and Liquid to format content, create reusable content, and write content for different versions on GitHub Docs. Using YAML frontmatter You can use YAML frontmatter to define versioning, add metadata, and control the layout for articles.
Creating reusable content You can create reusable content that can be referenced in multiple content files. Creating screenshots You can help users locate elements of the user interface that are difficult to find by adding screenshots to GitHub Docs. Creating diagrams for GitHub Docs This guide explains when and how to create diagrams for GitHub Docs. Creating tool switchers in articles You can use a tool switcher to show how to complete tasks using specific tools.
Configuring redirects If an article's title, version, or location changes, you can create a redirect to the current content. Changing an article's title When it's necessary to change the title of an article, the name may need to be updated in several places. Annotating code examples You can annotate longer code examples to explain how they work and how people can customize them for other uses. Templates This article contains starter templates for the different content types used in GitHub Docs.