Resources are packets of reusable information. They are the main way we store information.
Resources are shared truths in the Foundation for Public Code that everyone can work from.
Anatomy of a resource
The MarkDown of a resource file starts with the following metadata
--- type: Resource ---
Name of the resource
Followed by the name of the resource:
# Rationale for why spaghetti is the most superior food
Followed by the content of the resource.
For templates you can use code blocks. You can make a Markdown codeblock opened by:
and closed by:
If you want to indicate where things need to be filled in you can use curly braces,
}, to show where the content can be added.
Curly braces are preferred over square brackets since they do not clash with markdown syntax and over normal brackets as they stand out more.
Further reading section
At the end of your resource you can add a ‘Further reading’ section with relevant links to help people understand this topic or our rationale better.
## Further reading * [Find great cat gifs on Giphy](https://giphy.com) * [Find great dog videos on YouTube](https://youtube.com)