Summary for Docs team on December 07, 2020

Attendance

@chaion07, @bph, @paaljoachim, @atachibana, @mkaz, @tacitonic, @estelaris, @tjnowell, @fahimmurshed, @kenshino, @joyously,

Thanks to @chaion07 for facilitating the meeting.

Housekeeping

Project updates

  • @atachibana reported that the contents team continued migrating and re-routing Codex to Code Reference, and in this week we processed: 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.: 224 of 355 (63.1 % from 56.1% the last week) by @stevenlinx and @Mathew McCabe
  • External Linking Policy – there was a lack of input from the team on the post but we have a deadline so for the first review of 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 Developer Handbook we have two reviewers (even though we are aiming for 3) – @themiked and myself. I’ve already done the one for “undoubtedly allowed” links. @themiked please do yours this week if you can so that we can start applying results and keep the deadline by the end of this year.
  • GSoD Documentation Style Guide – I’m working on manifest.jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. file which is needed for parsing GitHubGitHub GitHub is a website that offers online implementation of git repositories that can 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/ markdown files to our very new Style Guide Handbook. Once I finish it, I’ll 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.” some good people from 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. to run it for the first time. Really looking forward to seeing this one.
  • We are asking all #docs team members to read the above post about External Linking Policy. We need your decisions and votes. As it is now, this will be a “two persons” decision.

:bee: -docs update
We have still three orphan pages on our to-do-list for 5.6

  • Updates: Image 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. page
  • new page: Image Editing features
  • Updates to Latest Posts
  • New contributor @incapit works on their first page.
  • Another new contributor will be on-boarded this week.
  • Experienced contributors are progressing in their work. @newyorkerlaura@cguntur @bizanimesh@collinsmbaka @geheren

New meeting time and holiday break announcement

The team chose to change the weekly meeting time to 14:00 UTC and this is the last meeting of the year 2020. We will reconvene again on 11 January 2021 at 14:00 UTC.

Monthly Coffee Break December 2020

After some discussion, we decided to skip the coffee break this month as it is too tight between the holidays and the State of the WordState of the Word This is the annual report given by Matt Mullenweg, founder of WordPress at WordCamp US. It looks at what we’ve done, what we’re doing, and the future of WordPress. https://wordpress.tv/tag/state-of-the-word/..

Google Season of Docs

Style Guide by @tacitonic

  • @milana_cap started with the manifest file for the Style Guide.
  • I’m currently writing the Formatting section.

Classification project by @dmivelli

  • I’ve reviewed the New Classification Recs tab on our worksheet.
  • I created new columns with subcategory suggestions for WP overview and Technical docs.
  • I’m still working on the Technical docs column.
  • I’ll continue this week and check in on progress by next weekend.
  • Link to the spreadsheet. We ask that peeps do not change anything, but feel free to add comments.
  • Also, the final reports by mentors and technical writer were submitted to Google last week.

There was a discussion as to what language (American English) is the basis of the style guide and there will be a focus on internationalizing the language. Also, the discussion area in GH is open, feel free to leave your comments there.

Discussion: Clarification about the use of GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. by WordPress plugins and themes

There was a discussion previous to the meeting on Slack. The conclusion is to point docs to the license page. @themiked clarified that the license question asked a few weeks back was mashed out and the license page for the plugin handbook was updated to include a link to the general WP license page and suggested the same approach is taken for the theme handbook.

#meeting-notes

Summary for Docs team on 30 November 2020

Attendance

@kenshino, @sasiddiqui, @sukafia, @atachibana, @chaion07, @dmivelli, @paaljoachim, @harishanker, @justinahinon, @softservenet, @collinsmbaka, @bph, @ibdz, @tacitonic, @estelaris, @saju4wordpress, @Geheren

Thanks to @chaion07 for facilitating the meeting.

Housekeeping

Project updates

Contents team

@atachibana mentioned that the contents team is migrating and re-routing Codex to Code Reference, and in this week we processed: 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.: 171 of 355 (48.2% from 43.1% the last week) by @stevenlinx. Thank you.
He is also removing duplicated method information in class references.

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 team

:bee: – docs team update was given by @bph There was a team sprint ( here is the Announcement) I was joined by four docs team members throughout the days for short period of times or asynchronously. 

Please welcome our newest contributor @Michael Geheren. Also, Chandrika Guntur @cguntur, Ahmed @chaion07, and Estela Rueda @estelaris.
We published/updated five pages, demo’d the publishing process and how to use the 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. Tester 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 (Videos are to come). We also noticed a few inconsistencies and recorded them on GitHub.Throughout the three days, we identified 21 pages that need updates for WordPress 5.6. They are all listed in the 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 >Needed Changes/ New Pages column. The list is also available in the Google Spreadsheet > Experienced Contributors 5.6 Tab. The source of Truth is the Trello board, though. I documented my process in posts to the Slack channel and will create a Google Doc with the steps for review by the team. @estelaris walked us through the current stages of Google Summer of Docs project on categorization and discoverability as it concerns the Block Editor End User documentation. It was a very enlightening conversation and it was great to see more people join. This was also recorded. Next Steps: 

  • Finishing up the videos
  • Reaching out to contributors to discuss their availability for these updates and 
  • Finish identifying update tasks.  
Stats for the block editor end user documentation

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/ developer documentation

@justinahinon posted the agenda for the meeting that will take place on Tuesday 1 December about Gutenberg dev docs https://make.wordpress.org/docs/2020/11/30/gutenberg-developer-documentation-zoom-meeting-agenda/. Anyone is welcome to join. There will also be a recording of the meeting and post a recap after.

External linking policy

The progress on External Linking Policy in Developer Handbook: https://docs.google.com/document/d/1BHu6mKy1DswNGv-O7FiBHDxM9RdAOLT0v3edimUQ5Kk/edit?usp=sharing. @milana_cap is asking for team feedback before publishing it on the #docs team blog.

New member mentoring

6 new members joined #docs in the week between 23 and 30 November 2020.

Monthly coffee break

Thanks to everyone who joined November’s coffee break. If anyone is interested to host the next coffee break then please let us know. We will share the date, time, and other details very soon.

New meeting time for #docs team

The docs team has chosen to change the time for the weekly meeting to 14.00 hrs UTC. There will be a post to make it official later this week.

Holiday schedule

The #docs team will take a holiday break from 14 December to 11 January and there will not be any weekly meetings. Yet, the channel is still open for those that want to continue contributing but we recommend that everyone takes a break.

Google Season of Docs 2020

The style guide update by @tacitonic

The categorization project by @dmivelli

I completed the review of the block editor articles and posted my title recommendations for review and approval. I will review the pillars and categorizations in the next two weeks. GSODs now entered the phase where I must complete my project report summarizing the results of my GSODs project.

Discussion: Structure of the handbooks

@paaljoachim is working on an idea to add all the support handbooks into one landing page. The idea is that there is too much documentation spread around making it hard to locate. He would like to present a better structure for documentation. If anyone has any comments, please add them below.

Open floor

@sukafia proposed to make the last call a Zoom call. If you would like to participate, please add your comment below or join next week’s meeting for more information.

@paaljoachim proposed to add the “public post preview” to the docs blog to help team review posts. @estelaris will add a 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. ticket for this.

Summary for Docs Team Meeting on 09 November 2020

Attendance

@crs1138, @chaion07, @leogermani, @atachibana, @tacitonic, @stefanocassone, @justinahinon, @veralee, @crstauf, @kafleg, @harishanker, @FahimMurshed, @sukafia, @mehbubrashid, @estelaris, @kenshino

Thanks to @leogermani for facilitating the meeting.

Housekeeping
Project Updates

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 Codex to Code Reference: @stevenlinkx and @collinsmbaka continued migrating and re-routing Codex to Code Reference: 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. 124 of 355 (34.9% < – 30.4%). @atachibana edited each method of information of the class references. @dd32 added a redirect to every page. No change in 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 until the external linking and the obsolete docs gets resolved.

Meeting Times

Due to the general confusion with the time-zones on the current Doodle, @kenshino will create a new Doodle and @crs1138 will notify all contributors who already voted on the original Doodle about the need to vote again.

New Member Mentoring

There are 5 new members joining #docs in the week between 2 and 9 November 2020.

Monthly coffee break (November 2020)

@estelaris will run the next monthly coffee break which will be on the Thursday 19 November 2020. The time for the coffee break should be Asia friendly and will be specified later on.

Google Season of Docs 2020

@tacitonic is currently working on the Punctuation section and updates the progress in the README file on the daily bases.

@dmivelli has finished reviewing the discoverability project and submitted a long list of typos and grammar errors that @estelaris will be fixing this week. There are also many titles that must be changed.

Docs Handbook and facilitating collaboration

@leogermani and @themiked rewrote a couple of pages but there is still more work to be done. As an example @leogermani pointed out the Projects page that could reflect more precisely what’s going on in their team. They also worked on the Workflow page. @leogermani suggests an idea to add a “report an issue” button to the pages to make it easier for people who want to collaborate to find their way.

@estelaris confirmed that this kind of button will be part of the new design of the articles template.

@themiked will add a link to the Reporting an issue page to the bottom of every plugin handbook page.

Deprecated Links

@themiked wrote down a document regarding the deprecated links and is asking for some feedback.

#meeting-notes, #meetings, #summary

Summary for Docs Team Meeting on 02 November 2020

Attendance

@chaion07 @atachibana @veralee @softservenet @harishanker @leogermani @kafleg @hellofromtonya @FahimMurshed @crstauf @kenshino @tacitonic @estelaris

Thanks to @chaion07 for facilitating the meeting.

Housekeeping
Project Updates

@bph posted an update asynchronous to the meeting.

  • The team will be working on the “Sprint for BEE-docs” during November 25 – 27, 2020. Details will follow. If interested, please leave a comment on the digital check-in post.

@atachibana informed about adding dropped information of Codex to code Reference and re-routing:

  • 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.: 108 of 355 (30.4% < – 25.4%)
  • He also spoke on editing method information of each class’ references.
  • He also thanked @stevenlinx and @collinsmbaka for their contribution. 

@milana_cap previously published a p2 post on HelpHub.

Meeting Times

The team is still awaiting responses to the Doodle link from everyone for the meeting time as many parts of the world have already begun adjusting to the Daylight Saving Times. Please cast your preferences using the Doodle link.

New Member Mentoring

@tacitonic informed the team that we didn’t have any new member joining #docs this week.

Monthly Coffee Break

7 people joined in the Monthly Coffee Break for October 2020 with an EU-friendly timing. A few snaps from the meeting were shared with the team. Thanks to @sukafia for facilitating it including @tacitonic, @crs1138, @chaion07, @thisisyeasin and others who joined.

The next Coffee Break will take place on the 26th of November (tentative). More info will be shared as we draw closer to the date. Please 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.” @sukafia or @chaion07 if you require further assistance.

Google Season of Docs

@tacitonic & @diana did not have anything new to add for this week.

@estelaris suggested that a meeting is scheduled for everyone involved in the GSoD project to take part in.

Open Floor

@joyously brought up this question, a few weeks ago: What to do with articles/pages that contain information that is no longer relevant or deprecated

@leogermani suggested adding a deprecation notice at the top of the page and link to relevant up to date content.

@themiked will write a p2 post covering different aspects of the topic discussed.

#meeting-notes, #meetings, #summary

Agenda for Docs Team Meeting October 26, 2020

The next meeting is scheduled with the following details:

When: Monday, October 26 2020, 05:00 PM GMT+2

Where: #docs channel on Slack.

Meeting Agenda

  1. Project Updates
  2. New Member Mentoring
  3. Monthly Coffee Break Reminder (October 2020)
  4. Google Season of Docs 2020
  5. Meeting Times
    • Review the Doodle for times proposed (time is in UTC)
  6. Discussion
  7. Open Floor

#agenda#meeting

Agenda for Docs Team Meeting October 19, 2020

The next meeting is scheduled with the following details:

When: Monday, October 19, 2020, 15:00 UTC

Where: #docs channel 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/..

Meeting Agenda:

  1. Project Updates
  2. External Linking Policy
  3. New Member Mentoring
  4. Monthly Coffee Break Reminder (October 2020)
  5. Google Season of Docs 2020
  6. Meeting Times
  7. Open Floor

#agenda, #meetings

Summary for Docs Team Meeting: October 5, 2020

Facilitator of the meeting : @justinahinon

Attendance

@justinahinon @crstauf @chaion07 @ibdz @atachibana @bph @tacitonic @softservenet @sukafia @diana @cbringmann @estelaris @collinsmbaka @themiked @kulsumsiddique

Agenda

You can find the Agenda here.

Notetaker: @kulsumsiddique

Notes Reviewed by: @collinsmbakaand @tacitonic

Facilitator for Next Meeting: @chaion07

Follow the meeting on the Slack channel for Docs

Project Updates

@atachibana: We are migrating and re-routing Codex to Code Reference, and processed:
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.: 62 of 355 (17.5% < – 14.4%) by @stevenlinx and @collinsmbaka .
He also did some housekeeping of Classes references.

External Linking Policy

Update from @themiked, here are the points that will need to be addressed regarding external linking policy

  • list all the 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 external links
  • define safe 5-10 links
  • remove the rest
Docs videos

@zzap shared earlier today the progress on “How-To” videos with a new one that has been recorded. @milana_cap finally recorded and uploaded contributing “how to” video for setting up local HelpHub instance. She have also added all the commands and URLs below video for easy copy/paste.

New Member Mentor Training

The Docs new-member Mentorship Team invites six newest member in the team.

Monthly Coffee Break

@sukafia is planning for a coffee break on Thursday 29th October 2020 in the European time zone and the meeting will be scheduled at zoom.

Google Season of Docs 2020

@tacitonic has shared the following update;

Update from @dianamivelli;

  • I noted more recommendations for Help Hub topics to reflect new topic title format (action+object)
  • Reached out to @tacitonic on #docs team to find out the correct Help Hub topic title capitalization style (sentence case vs. title case) @tacitonic, thanks for the speedy response :blush:
  • Contacted @estelaris and @timohaver to verify next steps are inline with project plan.
  • Added weekly status section to GitHubGitHub GitHub is a website that offers online implementation of git repositories that can 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/ repository to keep notes on weekly progress.
  • Added our project master doc to 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/. (still learning how to use Git effectively)
Open Floor

@estelaris suggested that Possessive should be WordPress’. All words ending in s will only have an ‘ at the end. @tacitonic and @dianamivelli agreed to it.

#docs, #meeting, #meeting-notes, #notes

Agenda for Docs Team Meeting October 05, 2020

The next meeting is scheduled with the following details:

When: Monday, October 05, 2020, 15:00 UTC

Where: #docs channel 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/..

Meeting agenda

  1. Project Updates
  2. External Linking Policy
  3. Docs Videos
  4. New Member Mentoring
  5. Monthly Coffee Break Update (October 2020)
  6. Google Season of Docs 2020
  7. Open Floor

#agenda, #meeting

Summary for Docs Team Meeting on 21 September 2020

Attendance

@justinahinon, @dianamivelli, @estelaris, @kartiks16, @tacitonic, @chaion07, @atachibana, @sukafia, @bobbingwide, @kulsumsiddique, @mkaz.

Thanks to @estelaris for Facilitating the Meeting.

Notetaker & Facilitator Selection

Notetaker: We could use a few volunteers to take notes for our weekly meetings. If you want to help then please comment here or let us know during our meetings.

Facilitator for the next meeting: @chaion07

Next Meeting: 28 September 2020

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/..

Project Updates

@milana_cap updated badges page with a new document and a process for tracking contributions. (asynch to the meeting)

@atachibana reported on the migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. and re-routing of Codex to Code:

  • 29 Classes out 43 have been completed which is an improvement of 7.4% leading to 67.4% from last week’s 60.5%, and
  • 51 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. out of 355 have been completed which is an improvement of 2.6% leading to 14.4% from last week’s 11.8%.
  • @atachibana thanked @stevenlinx for the contribution.
  • He also did some housekeeping on Codex this week and welcomed suggestions from everyone.

@bph also provided an update beforehand on Digital check in 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 Documentation (BEE-docs). Birgit requested that the BEE-docs team members leave comments on that post. (async to the meeting)

Docs Videos

@milana_cap fully recorded a contributing video and forgot to silent nearby devices and as a result there were a lot of background noises in the recording. Eventually had to delete it and she’ll attempt to re-record it. (async to the meeting)

External Linking Policy

@milana_cap reported prior to the meeting that the team started with the Plugin Developer Handbook for the discussion on External Linking Policy. @themiked outlined two phases. Please let Milana know if help is needed with this. We want to make the entire process transparent and publish on our blog. It’ll also help with defining the workflow for the other parts of #docs.

@themiked also reported that the goal is to compile a list of all the links on all the pages in the 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 guide and start with that, hopefully deleting them all and then adding back the ones on the approved domain list (asynch to the meeting).

New Member Mentoring Team

Due to everyone’s commitments, the Mentoring Team isn’t being able to properly focus on the Mentoring process for the past few weeks. The team is looking for new people to join over Making WordPress #docs team.

Please contact @sukafia, @softservenet, @tacitonic or @Prubhtej_9 with your ideas, suggestions and comments (if any).

Monthly Coffee Break Reminder (September 2020)

@sukafia provided the team with the schedule for the Monthly Coffee Break for September 2020.

Please 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.” @sukafia or @chaion07 if you require further assistance.

Google Season of Docs

@tacitonic reported:

  • Working Repository has been transferred to the WordPress organization on GitHubGitHub GitHub is a website that offers online implementation of git repositories that can 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/.
  • Almost done with the first section. You can read more about it here: https://github.com/WordPress/WordPress-Documentation-Style-Guide/tree/master/docs/2-document-guidelines (Overall status: one week ahead of schedule).
  • Waiting for a confirmation from the #docs team for a suitable location for the Style Guide on 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/ for a request that was made on the 15th of September

@dianamivelli reported:

  • Been reading HelpHub topics, making sure the titles are applicable, and suggesting new titles for some.
  • Raised the topic of identifying a consistent title style such as action+object for the title, when possible.
  • Further discussion is being done on a private Slack channel consisting folks from the #docs team that @estelaris had opened.

@estelaris added:

  • The Slack group includes both Technical Writers and all four mentors to discuss any topic that relates to both projects, as we will coincide in certain points and it is good to agree on the best approaches.
  • The big topic discussed this week was ‘Article Titles’. Removing Gerunds and adding an action+object title.
  • Also discussed the use of one-word titles.

The Technical Writers will be following the Handbook Grammar Guide as always. Thanks to @atachibana for sharing the link.

Open Floor

@bobbingwide asked if WordPress documentation could be kept up to date with the latest release? @estelaris answered that it would be really nice and the team is working hard to reach that goal. But since we had to migrate the articles from one site to another, we are taking the time to also update those articles. Another team is working on a new design for the pages. The Google Season of Docs Team is working on a new writing style guide and a new classification to implement a new navigation to documentation. There is also the Release Team who is working on adding documentation on the new releases. Not to mention the typos, broken links, small updates, etc that need constant upkeep.  With too many moving parts the team is working very hard and will reach our goal of having up-to-date, easy to find documentation soon.

@bobbingwide further asked, How committed is the Release Team to delivering the documentation for the new release concurrently with the new release? @joyously advised this question to be addressed in the Dev Chat and the editor in particular should be documented before being incorporated into coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress..

@bobbingwide also asked on the point of view of the docs team? @estelaris replied saying that the Release Team is very committed particularly to work on that and documentation needs to be ready before the public release.@mkaz added by saying there shouldn’t be a #docs team, that function should be a part of every feature development and those features shouldn’t be merged/released without documentation. @estelaris also shared the link to the 2020 WordPress Release Squad and another link to the WordPress 5.6 Release Planning @makz added by saying that it should be more integrated into the development of the features- if something doesn’t get merged without documentation, then you wouldn’t need a documentation squad for the release, by default it would be there.@justinahinon added async to the meeting by saying that one of the roles of the Release Documentation Team is to ensure that new things that come in the release receive proper documentation. So approximately 90% (estimation), new stuff in a release are documented by the date of the release. @estelaris invited @bobbingwide to attend the Dev Chats in the #core channel on Wednesdays at 8 PM UTC. @themiked added by saying that this may not be a priority for the Dev Team as there should be a docs representative for every release.

@tomjn asked if there is a document for how to contribute to docs that has all the things? @estelaris shared a link to the Docs Handbook. @mkaz also shared a link to the Block Editor Handbook. @jouisly suggested that the Handbook should be easier to discover.

@milana_cap suggested that we should make a list of the musicians in our team. She also shared her list and requested others who can play an instrument or into music to comment in this post.

#meeting-notes, #meetings

Summary for Docs Team Meeting: August 31, 2020

Attendance

@atachibana @justinahinon @chaion07 @bph @ibdz  @themiked @kenshino @tacitonic @b-07 @kafleg  @timohaver @kulsumsiddique  @dmivelli @bizanimesh  @thisisyeasin @benlk @mkaz

Agenda

You can find the Agenda here.

Notetaker: @b-07

Notes Reviewed by: @chaion07

Facilitator: @justinahinon

Facilitator for Next Meeting: @chaion07

Follow the meeting on the Slack channel for Docs.

Project Updates

@milana_cap  added patches on this 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. ticket https://meta.trac.wordpress.org/ticket/4915. She also started working on videos on how to set up a local HelpbHub instance.

@bph mentioned that we now have 32 pages to 5.5 status. She also updated the channel with the following information: 

  • New pages needed – 11
  • WordPress 5.5 – 31 
  • WordPress 5.4 – 15
  • WordPress 5.3 – 2
  • WordPress 5.0 – 18 
  • Pre WordPress 5.0 – 2
  • Total 79 pages

@atachibana mentioned that he and @stevenlinxf  migrating and re-routing of codex to code reference for

  • Classes: 21 of 43 (48.8% < – 30.2%)
  • 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.: 26 of 355 (7.3% < – 5.6%)

Stats and progress about it can be found here.

External Linking Policy

Here are some updates from @milana_cap

  • External linking policy meeting notes draft – In progress. The recording can be found here.
  • Set up HelpHub locally Contributing video – In progress. Please add your ideas here
  • Feedback form for HelpHub is under review: https://meta.trac.wordpress.org/ticket/4915
  • GSoD Style Guide project is going to be worked on at GitHubGitHub GitHub is a website that offers online implementation of git repositories that can 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/. The link will be shared as soon as the repository is created.

@mkaz will be doing a Hallway Hangout on September 1, here’s the announcement. 

New Member Mentor Training

@prubhtej provided new members update: 5 people have joined #docs in the last week. A total of 33 people have joined #docs in the month of August.

Monthly Coffee Break

We had Monthly Coffee Break for August on the 27th, 10 people attended.

@sukafia is going to set up another Doodle as usual and we will probably have a different Time Zone preference for the Monthly Coffee Break for September.

Google Season of Docs 2020

@dmivelli mentioned that she has created a master document for the GSOD Improve Article Discovery project. There she and @timohaver will keep details, decisions, and progress. 

Open Floor

There was nothing much discussed on the open floor. So @justinahinon ended the meeting.