Add to Guidelines

[bph]

This is a collection issue for a future update of the Tips and Guidelines. page. There is no particular urgency to it. It lists clarifications that came up in meetings.

Add ideas and issue in the comments.

[bph]

Note: Post title: Write a title that is clear for both the reader and search engines. Consider:

• usefulness for readers,
• search,
• ease for identifying cross-links with content produced within the project, and
• expectations of reader/ differentiation of content.

[bph]

Use Photos from the WordPress.org photo directory. and add props to the article.

Example: https://developer.wordpress.org/news/2023/02/creating-custom-block-styles-in-wordpress-themes/ Photos by @kharisblank, @stephendumba1, and @roytanck from the WordPress photos directory.

[bph]

Contribution & Props.

Once published, the author of the post will receive and entry into the Wp.org profile Activity tab.

In addition to adding props for reviewer on the bottom of the post, the author is asked to also add them to the #props channel at WP Slack space, using the Slack user names. From that message, it'll be added to the Activity Tab of the profiles as well.

Example:

[bph]

Formatting Tips and shout outs.

• https://github.com/WordPress/wporg-developer-blog/issues/40 once we have some styling for those, we need to add them to the guidelines

[bph]

What is expected for first and second reviewers?

Copy-editing should happen in the first review in Google Doc The second review should happen as draft post on the site and follow publishing standard and pre-publish check list. If there are necessary copy-editing changed to be made, communicate them in comments of the GitHub issue rather than introduce changes to the draft post on the site.

With the 3rd phase of Gutenberg, we should be able to better collaborate on text changes on the WordPress site. Until then, let's try to make all copy-editing changes in the Google Doc.

[bph]

Use the Pattern Dev Blog TOC for your table of contents needs.

Details

• Two core blocks: Paragraph + Table of Contents block
• in a group
• with background "Blueberry 4"
• Padding: Present "Small"

The bullet list formatting set with Custom CSS of the Global Styles > Blocks > Table of Contents> Advanced

 ol {
  list-style: disc;
}

[bph]

This is now outdated. and I close this issue

There is a table of content pattern available, fully styled and with a header.