Skip to content

document key content design considerations for blogs #11702

@susanev

Description

@susanev

overivew

was chatting with @SaraDPH about content design and our blogs. i think it would be good to document what folks should keep in mind when writing blogs, e.g, if a video is included it should be near the top of the blog, keep paragraphs to 8 sentences or less, use lists when providing instructional directions, etc.

we could add this information to https://github.com/pulumi/pulumi-hugo/blob/master/BLOGGING.md or https://github.com/pulumi/pulumi-hugo/blob/master/STYLE-GUIDE.md or some other place, then maybe also include it in the pr template for blogs (if we have one)

Metadata

Metadata

Labels

area/blogContent issues on blog posts.kind/engineeringWork that is not visible to an external userkind/enhancementImprovements or new features

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions