Summary of Docs Team Biweekly Meeting (September 19, 2023)

Attendance

@leonnugraha @anandau14 @noumantech @sagargurnani @femkreations @milana_cap @sumitsingh @cold-iron-chef @devmuhib @webcommsat @MuhammedIqbal @atachibana @ShiponKarmakar @estelaris

Housekeeping

Next Meetings Facilitators and Note Takers

Project Checks

@milana_cap was at WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Finlandia Contributor DayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/. last week. Many new contributors. The takeaway is that it is difficult to start contributing, perhaps we should include workflow instructions in each issue.

@anandau14 submitted an article for review and @milana_cap added [status] * labels to issues in WordPress End-User Docs Inventory. @noumantech and @sagargurnani continue working on their assigned issues.

@estelaris attended WordCamp Pontevedra (spain) where she gave a talk on the importance of translating end-user documentation, as well as started working on the first steps for the main  translation project. And during contributor day, the Spanish team started working on a writing style guide based on what we have in docs for English language.

@MuhammedIqbal showed interest in beginning translation in Malayalam.

@milana_cap suggested to stop adding new release changes to the same issue and instead, open new issues for each release. The reasoning behind it “imagine someone just starting to translate to their local and they see 5 versions of update.”

@noumantechasked for the procedure to write a post for the Make blog and was explained by @milana_cap and @estelaris that on the blog we can only write about documentation and related topics. Always check with team reps about the topic and ask another contributor to review grammar/style/tone. Having access to the docs Make blog doesn’t give us access to any of the other Make blogs, each one belongs to different teams and should check with team reps when wanting to write about a topic relevant to another team.

#meeting-notes

Summary for Docs Team Meeting: 23 November 2021

Attendance

@chaion07, @Femy, @mitchblue, @milana_cap, @bedas, @mkaz, @Courtney, @peteringersoll, @estelaris.

Housekeeping

  • Meeting Facilitator: @chaion07
  • Note Taker: @bedas
  • Next Meeting: 07 December 2021, Tuesday
  • Next Meeting Facilitator: N/A
  • Next Week: Docs Issue Triage

Project Updates

@mkaz continues working on this issue https://github.com/orgs/WordPress/projects/11/

@milena_cap continues her work on Common APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. handbook.

@Femy continues to work on Removing technical details from user docs and rewriting them.

@mkaz mentioned tweets in regards to requirements to update DOC (themes) in regards of Blocks, this issue is forwarded to @poena, @acalfieri and @kafleg.

@mitchblue has started working on screenshots. Additional help is welcome to tackle the issues listed at https://github.com/WordPress/gutenberg/issues?q=is%3Aopen+is%3Aissue+label%3A%22%5BType%5D+Documentation%22 or https://github.com/WordPress/Documentation-Issue-Tracker/issues.

@estelaris mentioned that a new video would be required to explain the purpose of a Blog better and in a more up-to-date fashion. TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. task here https://trello.com/c/cfDu3rtG/358-blogging-with-wordpress.

@peteringersoll is introduced as new member of training team and being in charge of relaying information across DOC and Training Teams.

Thanks to @bedas for preparing the notes. Unfortunately he wasn’t available to publish the notes which is why I am publishing this on behalf of him.

#meeting-notes, #meetings, #notes, #summary

Summary for Docs Team Meeting September 14, 2021

Housekeeping

Attendance

@atachibana, @mburridge, @TC , @ashiquzzaman , @femKreations,  @kmhazari , @estelaris , @Basil, @joyously , @danfarrow , @Kenshino (Jon) , @themiked ,

Where: #docs channel on Slack

Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @TC

Note Taker: @ashiquzzaman

Project Updates

From @atachibana For contents side, all issues in the repository were labeled and active discussions are on going.
Stats: 18 Open / 9 Closed.

Open Floors

estelaris highlighted on using both Google Spreadsheet and 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/ for different issues. Upon discussion it was agreed that we

#meeting-notes, #summary

Summary for Docs Team Meeting July 6, 2021

Housekeeping

Attendance

@ashiquzzaman@femkreations , @chaion07, @thisisyeasin, @manzwebdesigns , @annezazu, @milana_cap, @tacitonic, @mburridge, @kmhazari ,

Where: #docs channel on Slack

Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @chaion07

Note Taker: @ashiquzzaman

Next Meeting Facilitator: @milana_cap

Open floor

 @Michael Burridge interested in 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 End User Docs Project Lead’ position.

@Femy wrote HelpHub updates, @zzap to review later

#meeting-notes

Summary for Docs Team Meeting June 29, 2021

Housekeeping

Attendance

@milana_cap, @ashiquzzaman@atachibana, @mburridge @mkaz@femKreations, @tacitonic, @kmhazari @chaion07, @joyously @themiked, @manzwebdesigns 

Where: #docs channel on Slack

Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @ashiquzzaman

Note Taker: @femKreations

Next Meeting Facilitator: No volunteers found for facilitation of next week’s meeting. Volunteer over #docs 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/. if you can do this.

Project Updates

Doc update for 5.8 update release

Update from @milana_cap:  WordPress 5.8 release cycle today enters Release CandidateRelease Candidate A beta version of software with the potential to be a final product, which is ready to release unless significant bugs emerge. 1 phase. This means that all dev notes and field guides should be published today (June 29, 2021). Once that’s done the doc team will move on to updating DevHub and HelpHub. @femKreations is currently working on the HelpHub updates, hence a lot of HelpHub is ready.

The doc team also has a new 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 activated at HelpHub and DevHub, which allows the documentation team to edit already published posts and pages and schedule changes for later date while existing content is intact.

Update from @tacitonic:  No new updates for the Style Guide. Currently working on the article for C.

New Member Mentoring

Update from @chaion07:  A schedule is being prepared to support the onboarding of new members. A link to the form will be shared in a blog post (P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/.) for the convenience of everyone. The team is aiming to start in early July.

Monthly Coffee Break: Also for Docs Coffee Break The team is unlikely to have one for June due to the unavailability of coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. members and a lot of contributors struggling to find time due to COVID.

@mburridge will be working with @chaion07 for guidance and mentoring to get started with contributing to the docs team.

Audit Tool Proposal Update (proposed by the Training Team)

@courane01 and @milana_cap have a meeting scheduled on Friday, July 2. 2021 to review how the docs audit HelpHub/DevHub currently and collect the feature requests for the audit plugin/tool. Also to be determined what in the tool would benefit the docs workflows.

DevHub & HelpHub updates

@justinahinon’s raised few questions on DevHub:

  • Is there a reason why the WordPress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. documentation is hosted on Codex (https://codex.wordpress.org/WordPress.org_API), and not on DevHub?
  • It seems like WordPress.org API documentation could benefit from some improvements, by adding examples, use cases, and endpoints, for example. But it also seems like some of these are intentionally not documented because they are not meant to be used by third parties. Is this the case, and if yes, where should we look to find what should not be documented?

@milana_cap suggested discussing this with the #meta team and see if there’s a good place for such documentation.@atachibana suggested Common API Handbooks to add the WordPress.org API documentation. @milana_cap and @atachibana agreed that adding the WordPress.org API documentation to the Common API Handbooks would be confusing.

@femKreations will continue working on the HelpHub

Doc Team is looking for 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 End User Docs Project Lead. @mburridge has shown interest and would consider the role after onboarding.

Update from @milana_cap The categorization of support articles is still in progress. @estelaris is working on the site search and it will be done soon.

Open Floor

@joyously asked about the categorization of support articles?

@milana_cap commented that it’s still in progress.

#meeting-notes

Summary for Docs Team Meeting June 22, 2021

Attendance

@milana_cap, @courane01, @kmhazari, @chaion07, @femKreations, @tacitonic, @atachibana, @mehbubrashid, @ramthas, @kenshino, @mehbubrashid, @caseymilne, @deadpool76, @piermario, @estelaris, @collinsmbaka, @mburridge, @kafleg, @daisyo, @ahmedriyadh, @themiked

Housekeeping

Where: #docs channel on Slack
Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @milana_cap

Note Taker: @caseymilne

Next Meeting Facilitator: No volunteers found for facilitation of next weeks meeting. Volunteer over #docs 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/. if you can do this.

Project Updates

Proposal Update: An audit tool for Learn

Update provided from @courane01. No deadline set at the moment. Proposal gaining interest from team leaders, Learn/Training team will see a few new contributors from Automattic. Importance of streamlining auditing for teams mentioned, new Instructional Designers that are on-boarding at Learn. 

Discussion about revision management and the importance of tracking changes. Some questions from facilitator @milana_cap about existing tools used in editing workflow. 

Plans to continue collaboration between #docs and #train on this proposal, to set to write up docs needs in two weeks time, and have a video chat to discuss further.

5.8 Release

  • Today we’re entering betaBeta A pre-release of software that is given out to a large group of users to trial under real conditions. Beta versions have gone through alpha testing in-house and are generally fairly close in look, feel and function to the final product; however, design changes often occur as part of the process. 3 phase. 
  • By the next Tuesday (when RC1 is starting) we’ll have all dev notes and field guide published
  • After that we start working on DevHub and HelpHub updates

Volunteers: anyone wants to help with DevHub, pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” @milana_cap over Slack #docs.

@atachibana shares that at WordCampWordCamp WordCamps are casual, locally-organized conferences covering everything related to WordPress. They're one of the places where the WordPress community comes together to teach one another what they’ve learned throughout the year and share the joy. Learn more. Japan 2021 there were many new contributions, one team is creating an end-user manual. Reference link https://jawordpressorg.github.io/user-manual/1_login/.

@chaion07 is focused on onboarding new members. Meeting will be set later this week for new members, details posted later on P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/..

Docs #docs team is actively looking for new members and a new 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 End User Docs Project Lead. Block Editor End User Docs behind by 2 releases. For reference on this project see TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. board at https://trello.com/b/JnTCzOsL/gutenberg-end-user-docs.

@femKreations is continuing work on the Site Health docs.

#meeting-minutes, #meeting-notes, #taking-notes, #updates

Summary for Docs Team Meeting May 18 2021

Attendance:

@crstauf@chaion07 , @tacitonic, @bph @kmhazari, @ashiquzzaman@milana_cap@kenshino, @atachibana , @mkaz@piermario,  @clorith,  @stefanocassone , @kmhazari,

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: Tuesday, 18 May 2021, 20:00 GMT+6

Meeting Facilitator: @milana_cap
Note Taker: @ashiquzzaman

New Member Mentoring:

10 new members have joined the #docs team since the last meeting on May 11, 2021. Let us all welcome @piermario@dineshjain2911@satsilem@colind@Gegham Hakobyan@Grogou@Paul Bigai@Plenet@Kevin Cunningham

Project Updates:

@atachibana from content side there are no major works, though he’s working personally to translate GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/ documents to Japanese.

@tacitonic For the Style Guide, he’s completed 23/28 articles in the Word list. In the last week he’s completed the article on I, and this week working on E.

@bph The Docs team is invited on May 20th Gutenberg release notes and identify user facing features and enhancement for existing and new pages. The time is – 2 pm EDT / 20 UTC – it’ll be a live working session and @zzap will join as doc lead for 5.8.

If anyone would like to help with 5.8 End user documentation for Full Site Editing and 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 you should participate in the Test #6.

@zzap is populating spreadsheet with tickets that need dev notes and docs, @audrasjb already volunteered to do one dev note for For 5.8 release update. Anyone who wants to help with either dev notes or docs for dev or end user, Feel free to pingPing The act of sending a very small amount of data to an end point. Ping is used in computer science to illicit a response from a target server to test it’s connection. Ping is also a term used by Slack users to @ someone or send them a direct message (DM). Users might say something along the lines of “Ping me when the meeting starts.” @zzap on slack.

Moving Docs from Codex to DevHub:

@kenshino highlighted few tickets 1645 and 5738 and the team is working on a way to from away from Codex to DevHub. The team is thinking of implementing a feedback box telling people to go to forums for support instead of HelpHub. The team is looking for volunteer to look through the comments that come in for HelpHub. @zzap will publish a P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. blog about it for vounteer.

#meeting-notes

Docs Team Coffee Break April 2021 Summary

The April 2021 Coffee Break took place on the 30th instant at 0900 AM UTC timing which saw the presence of 7 contributors from the Global Documentation Team. Kudos to @chaion07 for hosting!

Smiles all around with a few familiar faces at the start of the April 2021 Coffee Break

The Coffee Break for April began with an APAC friendly timing, which was a result of an impromptu announcement to a discussion which lacked a response from the team. Nonetheless with a little help from one of the newest Team Reps, @atachibana announced the @here call and we saw a few contributors joining instantly to the Zoom Call. Thanks to @ashiquzzaman, @thisisyeasin, @gtarafdarr, @atiktonmoy, @imtiazprotik & @nahidsharifkomol for attending the April 2021 Coffee Break.

A few random questions we asked during the coffee break that everyone participated in are:

  • An app mysteriously appears on your phone that does something amazing. What does it do?
  • If you had your own intro music, what song would it be? Why?
  • What is the one thing you miss about being a kid?

We thank those who attended the Docs Team Coffee Break. We invite all of you to join the coffee break for May 2021 as it progresses from planning to execution.

#coffee-break, #meeting-notes, #meetings

Summary for Docs Team Meeting April 19 2021

Attendance:

@crstauf@chaion07 , @tacitonic , @justinahinon , @atachibana , @estelaris , @bph @kmhazari, @stefanocassone , @engramium, @mkaz, @collinsmbaka, @milana_cap, @tomjn, @paaljoachim, @clorith, @annezazu, @kenshino, @themiked , @joyously, @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, April 19, 2021, 14:00 UTC

Meeting Facilitator:  @ashiquzzaman
Meeting Note Taker: @kmhazari
Note Reviewer: @ashiquzzaman

Next Meeting: Monday, April 26, 2021, 14:00 UTC

Project Updates:

From @bph, 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 End-user documentation –

  • Getting ready for the 5.8 release.
  • Need volunteers to help with prep and writing.
  • She will create a post for the team blog to outline a plan proposal
  • This week she will check back with contributors work in progress and Need changes cards in TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. and see if there are blockers.
  • A Few 5.5, 5.6, and 5.7 residues to finish.
  • Please read the post by Josepha the final scope for 5.8 for the block editor

From @tacitonic, No substantial updates for the Style Guide, 21/28 articles have been completed in the Word list.

From @tjnowell, VVV project regarding contributor dayContributor Day Contributor Days are standalone days, frequently held before or after WordCamps but they can also happen at any time. They are events where people get together to work on various areas of https://make.wordpress.org/ There are many teams that people can participate in, each with a different focus. https://2017.us.wordcamp.org/contributor-day/ https://make.wordpress.org/support/handbook/getting-started/getting-started-at-a-contributor-day/.

  • He’s liaising with @paaljoachim and @macgraphic to improve some coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. docs
  • VVV installation docs were heavily simplified over the weekend and uninstall instructions added, documenting these in handbooks is no longer necessary, a link will do
  • Adding a new site was overhauled with basic Trunk/MetaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. env instructions
  • Changing instructions from installing to vagrant-local to vvv-local instead, lots of people think VVV and Vagrant are the same thing which is confusing, this should avoid some of that. Some .org docs will need updating


Team goals updates:

From @tacitonic,
For the Style Guide:
Priority: Completing the last remaining section.
Challenge: Parser inconsistencies.
Big Win: Style Guide was published.

From @justinahinon,
Restructuring of the block 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.

From @atachibana, Content team completed the hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. and classes migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies..

From @paaljoachim,
As soon as the Code block is fixed in Learn. He plans to publish
Setting up a local WordPress Development Environment for Core and Testing a TracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. ticket or a Github PR.
He plans to create a Learn tutorial for VVV/Vagrant when he and Tom are finished with the VVV/Vagrant docs.


New Member Mentoring:

We have 16 members joining the #docs team since March 29, 2021. Please welcome the following Contributors 
@knutsp@Kim-Agape3.com@greduan@dirgha@Dulé@sebastienserre@Meghaa@Tyler Baldwin@Gaston Rubiolo@Amit Dudhat@Arnold W. K.@Vince@Sahil Mepani@igdeman@Chris Bell and @itowhid06

We have a Mentoring Team consisting of a few contributors in the #docs Team. One of the members from the Mentoring Team might reach out to you to assist you with your inquiries on contributing to the team. Thank you!


Google Season of Docs:

Update from @justinahinon, doc team applications have not been accepted for this year’s Season of Docs. He added some details and next steps to move forward as a short update on this post.


Unified Doc License page:

From @kenshino,
For the Unified Doc License page, he’s written a draft here. The doc team can use the text as written to make clear out intentions. The next 2 steps for this are sending the text to @chanthaboune so she can get the lawyers to review
Adding a link to the licensing page on the documentation page footers (or some other appropriate unified mechanism)

If there’s anything anyone like to add or comment, now is the time.


Author attribution to docs:

From @kenshino,

For Author attribution. The doc team should start recording and showing results. The team can start with DevHub (HelpHub has forums installed on the /support site so it’s a more complicated setup and should be tackled after some testing).

Recommended 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 – authorship, Beyond the ability to denote multiple authors, it also has the ability to do so via CLICLI Command Line Interface. Terminal (Bash) in Mac, Command Prompt in Windows, or WP-CLI for WordPress. (not just UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing.), so in the ideal case (with some custom dev) we can integrate that with the RESTPlain setup so GutenbergGutenberg The Gutenberg project is the new Editor Interface for WordPress. The editor improves the process and experience of creating new content, making writing rich content much simpler. It uses ‘blocks’ to add richness rather than shortcodes, custom HTML etc. https://wordpress.org/gutenberg/, official function/hook docs when synchronized from GitGit Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency. Git is easy to learn and has a tiny footprint with lightning fast performance. Most modern plugin and theme development is being done with this version control system. https://git-scm.com/. / SVNSVN Apache Subversion (often abbreviated SVN, after its command name svn) is a software versioning and revision control system. Software developers use Subversion to maintain current and historical versions of files such as source code, web pages, and documentation. Its goal is to be a mostly compatible successor to the widely used Concurrent Versions System (CVS). WordPress core and the wordpress.org released code are all centrally managed through SVN. https://subversion.apache.org/. can attribute authors via CLI. There’s obviously more to talk about and this is likely a project in itself.


April Coffee Break:

Due to both @chaion07 and @Sunday Ukafia not being available for the past few weeks. The coffee break for March wasn’t commenced, they will write a P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. ask for hosts if interested in April.


Process gap between dev notes release stage:

@clorith requests the doc team to make it ready before dev notes, dev notes usually land around the Release CandidateRelease Candidate A beta version of software with the potential to be a final product, which is ready to release unless significant bugs emerge., which only gives 2-3 weeks. Even if screenshots may need updating near the end, the concepts should land before RCRelease Candidate A beta version of software with the potential to be a final product, which is ready to release unless significant bugs emerge., when the merge deadline is met. This is to help the support team to make support easier for them.

@estelaris raised the issue to Josepha but haven’t got an update yet.

@mkaz also agreed, getting features being released in a major version should be documented to coincide with the release, there are numerous tickets open to address.


Open Floor/Q&A:

From @mkaz, A short update for block editor handbook discussion, looks like consensus the “block editor” name covers all editors since they all are block editors. So next steps are to build out a good landing page with FSE docs with a focus on what is going out in WP 5.8 as decided here.

@estelaris stated it’s best to continue the discussion about this topic and post a P2 explaining the gap and any solutions the doc team suggests. She also commented on the issue with @Matt said he is willing to support the work of the docs team (on the HelpHub front). She stated the doc team need to raise the importance of end-user documentation, within the release squad, there is never a plan for writing end-user documentation

@milana_cap thinks, one of the ways could be having lists explaining new features in bullets after which the doc team can go and ask more questions if needed deeper explanation. But what the doc can’t know and would need for sure is what the feature is about, why is it important, what problem it solves.

@clorith mentioned, as soon as a feature proposal is accepted, work is started on the features that are already marked as “final”. Then once the merge deadline hits, start documenting the concepts and how the feature works in broader terms. This means once you reach RC, all that should be missing is screenshots and maybe a few adjustments for labels, and the documents can be published.

By publishing at the same time as RC goes live, Dev can help both the Doc and Support team, since they can get familiar with the material, but also users who are willing to test the RC can find information on the features, to know what is there that they can test

@bph agrees that the release team only considered Dev Notes, not end-user documentation. The docs team is fairly new and still doesn’t have enough people around to scale up the operation. With her work on Gutenberg Times, she’s in a unique position to keep up-to-date on the development and learn early when features arrive and how to get a task list going.

With the help of @geheren the team has a good system in place. What’s missing are the contributors to update existing pages, write the new pages, and are proficient enough in the new features to guide the users on exploring the new features. Most contributors who are new to the feature need guides themselves unless they have a certain curiosity and explore each feature deeper.

@geheren and @bph will review all the changes from the plugin (Gutenberg 9.9 – 10.7) release notes to see how the existing page needs updates. Update the Trello cards of existing pages and also review the template page editor and the new blocks to determine an outline 

#meeting-notes

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