Summary for Docs Team Meeting April 12 2021

Attendance: @crstauf, @chaion07 , @tacitonic , @justinahinon , @FahimMurshed , @atachibana , @estelaris , @bph , @stefanocassone , @themiked, @ashiquzzaman

Housekeeping:

Where#docs channel on Slack.
Find the complete Transcript of the meeting on SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/..
When: Monday, 12 April 2021, 20:00 GMT+6
Meeting Facilitator: @tacitonic
Meeting Note Taker: @ashiquzzaman
Next Meeting: Monday, April 19, 2021, 08:00 PM GMT+6

Project Updates:

From @tacitonic For the Style Guide:
Priority: Completing the last remaining section.
Challenge: Parser inconsistencies.
Big Win: Style Guide was published.
For the Style Guide, @tacitonic completed 20/28 articles in the last section.

From @themiked PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party Handbook
Priority: 
1. Applying an external linking policy to pages as appropriate  
2. Picking a single page and applying a style guide to it
Challenge: not losing my mind in syntactic pedagogy
Big Win: the above

@tacitonic inquired about whether the external linking policy finalised, because external linking articles in the style guide are on hold for that.

To which themiked replied – Partial implementation has been done.

@bph no updates

From @justinahinon: For the restructuring of the blockBlock Block is the abstract term used to describe units of markup that, composed together, form the content or layout of a webpage using the WordPress editor. The idea combines concepts of what in the past may have achieved with shortcodes, custom HTML, and embed discovery into a single consistent API and user experience. editor handbook:
Priority (for next quarter): Continue iterating on the current documentation
Challenge: The fact that the doc is synced on GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/ and parsed sometimes leads to challenges (redirections, syncing errors, live updates, etc..)
Big Win: The initial restructuring plan was completed.


Team goals updates:

Q1 team goals updates:

@zzap requesting all project reps to visit the – Team goals for Quarter 1, 2021 post and report progress in the format:

Priority (for next quarter): 
Challenge: 
Big Win:

Google Season of Docs

The team is waiting for Google’s announce of selected projets, which is planned for next Friday.

In the meantime, the comments are still open on the projects ideas list https://make.wordpress.org/docs/2021/03/26/google-season-of-docs-2021-project-ideas-list/


Open Floor

@justinahinon shared tasks French WordPress documentation team is working on, that can be useful for EN docs team – 

the French WordPress documentation team has been working on something really interesting in relation to the user documentation of the editor blocks.

Instead of rewriting the description and functioning of the common options for each block, the French Doc team created pages for those parts which are then reused in the block articles.

For example, block options like advanced settings, typography, colors and parts of the block toolbar are shared by all blocks. Having their docs separate makes it easier to maintain them, and not have to make changes to a dozen or so articles when there is a change in the editor.

@audrasjb made a screenshot with annotations to show how it works.

This is led by @jdy68 and @chaton666

#meeting-notes#meetings#summary

#meeting-notes

#meeting-notes