eca5b64ed5
* Add section about GitHub Pages workflow run * Create a reusable step for checking workflow run * Add a public beta reusable note * Add new reusable for checking workflows for build errors * Add new reusable and new sections to this article * Add that space * Convert reusable to regular text * Add alternate CI caveat to reusable * Playing with spacing * Change versioning to fpt only * Fix formatting for reusable with note * Add troubleshooting detail * Apply suggestions from code review Co-authored-by: Yoann Chaudet <yoannchaudet@github.com> * Apply suggestions from code review * Reframe step without resuable * Remove resuable for now * Apply suggestions from code review Co-authored-by: Sarah Edwards <skedwards88@github.com> * Apply suggestions from code review * Revamp the reusables * Apply suggestions from code review Co-authored-by: Sarah Edwards <skedwards88@github.com> * Apply suggestions from code review * Apply suggestions from code review Co-authored-by: Tommy Byrd <tcbyrd@github.com> Co-authored-by: “jmarlena” <“jmarlena@github.com”> Co-authored-by: Octomerger Bot <63058869+Octomerger@users.noreply.github.com> Co-authored-by: Yoann Chaudet <yoannchaudet@github.com> Co-authored-by: Sarah Edwards <skedwards88@github.com> Co-authored-by: Tommy Byrd <tcbyrd@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 %}.