From aa4fcb0008f8b201abbc5c9858f4e773d35cd29e Mon Sep 17 00:00:00 2001 From: Sarah Schneider Date: Tue, 17 Nov 2020 18:22:27 -0500 Subject: [PATCH] document the dev-toc --- contributing/development.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/contributing/development.md b/contributing/development.md index 7c6f3b297b1f..cbd0be675d67 100644 --- a/contributing/development.md +++ b/contributing/development.md @@ -26,12 +26,19 @@ When you're ready to stop your local server, type CTRLc in Note that `npm run build` is a one-time step that create static assets. + ### Using GitHub Codespaces As an alternative, you can simply use [GitHub Codespaces](https://github.com/features/codespaces). In a matter of minutes, you will be ready to edit, preview and test your changes directly from the comfort of your browser. +### Viewing a top-level TOC + +While running the local server, you can visit [localhost:4000/dev-toc](http://localhost:4000/dev-toc) to view a top-level TOC of all the content in the site. This page is not available on https://docs.github.com. It was created for internal GitHub writers' use. + +At the `/dev-toc` path, you'll see a list of available versions. Click a version, and a list of products will appear. Note that the TOC content is versioned. If you are viewing `free-pro-team@latest` and you click the `Enterprise Admin` product, it will be empty, because there isn't any Admin content available on that version. + ## Site structure This site was originally a Ruby on Rails web application. Some time later it was converted into a static site powered by [Jekyll](https://jekyllrb.com/). A few years after that it was migrated to [Nanoc](https://nanoc.ws/), another Ruby static site generator.