e820d306df
* First rewrite * draft commit * Rework this draft * Add extra article * Revert "Add extra article" This reverts commit 690c1ba67af9c94b62429bddf59b5b6c4d4c7634. * remove https:// * Fix chart * Change order * Apply suggestions from code review * Rewrite this section * Don't need this update * Revised draft * Apply suggestions from code review * Some tweaks * Add new section * Rework permission description * Rework new procedure * Revisions * Fix this link * Tiny fixes * Tweaks * Apply @hubwriter's input Co-authored-by: hubwriter <hubwriter@github.com> * Apply suggestions from code review Co-authored-by: hubwriter <hubwriter@github.com> * Create reusable for token security explanation * Typo * Add more context * Revise for consistency * Missing part of a link * A bit more context * fix link * Apply suggestions from code review Co-authored-by: Sarah Edwards <skedwards88@github.com> * Apply suggestions from code review * Apply suggestions from code review * Apply suggestions from code review * Found a typo Co-authored-by: hubwriter <hubwriter@github.com> Co-authored-by: Sarah Edwards <skedwards88@github.com>
Reusables
Reusables are long strings of reusable text.
Reusables are longer strings like paragraphs or procedural lists that can be referenced in multiple content files. Using Markdown (instead of YAML) makes it possible for our localization pipeline to split the strings into smaller translatable segments, leading to fewer translation errors and less churn when the source English content changes.
Each reusable lives in its own Markdown file.
The path and filename of each Markdown file determines what its path will be in the data object.
For example, a file named /data/reusables/foo/bar.md will be accessible as {% data reusables.foo.bar %} in pages.
Reusable files are divided generally into directories by task. For example, if you're creating a reusable string for articles about GitHub notifications, you'd add it in the directory data/reusables/notifications/ in a file named data/reusables/notifications/your-reusable-name.md. The content reference you'd add to the source would look like {% data reusables.notifications.your-reusable-name %}.