1
0
mirror of synced 2026-01-04 18:06:26 -05:00
Files
docs/data/reusables
Emily Gould a06ea17a4b Make Building a strong community a top-level doc set (#18396)
* Move directory to new location

* Update new index page

* Create wikis category

* Create blocking category

* Create moderation category

* Make map topics into category indexes

* Create contributions category

* Create template category

* Add redirects

* Add new product to products.yml

* Rename product for URL purposes

* Update links to wiki content

* Update links to maintaining safety articles

* Update links to moderation content

* Remove old category from github product index

* Fix links

* Update links to healthy contributions articles

* Update links to template articles

* Fix links
2021-03-29 16:40:32 -05:00
..
2020-11-02 15:12:44 -06:00
2020-11-02 15:12:44 -06:00
2021-02-26 09:03:25 -05:00
2020-12-09 20:02:21 +00:00
2020-11-02 15:12:44 -06:00
2021-02-26 23:32:54 +01:00
2020-09-27 14:10:11 +02:00
2021-03-16 07:58:04 +00:00
2020-11-02 15:12:44 -06:00
2021-03-12 13:53:38 -08:00
2020-11-04 21:04:48 +01:00
2020-09-27 14:10:11 +02:00
2021-03-04 10:52:15 -08:00
2020-09-27 14:10:11 +02:00

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 %}.