agaric/documentation
10
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add blog post writing to content entry docs; update and add link to styleguide

Browse source
This commit is contained in:
benjamin melançon 2020-07-08 10:33:25 -04:00
parent 4690701490
commit 4d8b9c6136
1 changed files with 13 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
agaric-website/agaric-site-content-entry.md
View file

@ -1,11 +1,21 @@
# Content entry on Agaric's own sites
**Or, a guide to Agaric's experimental branch of Drutopia**
*Or, a guide to Agaric's experimental branch of Drutopia.*
First, familiarize yourself with Agaric's tone and voice guide. [TODO add link]
First, familiarize yourself with Agaric's tone and voice as described in [Agaric's content style guide](content-style-guide).
Second, add content like you would on any web site, with the following caveats in mind.
Second, add content! Most commonly, this will be blog posts.
## Writing Blog Posts
* Use title case
* Keep summary text to one sentence when possible.
* Write a summary that gives a glimpse into the content, piquing the reader's interest
* Use headings and lists to break up content
* Include pictures and screenshots when possible
* Use captions to highlight key points of the post
## Use Title paragraphs on Case Studies and certain pages
To give control over the header layout to content editors, we've created a paragraph type called 'Title'. If it is present on content being shown as a full page, it uses its image, title, and subtitle to replace the usual header and page title section.