Agenda for Docs Team Meeting July 06, 2020

The next meeting is scheduled with the following details:

When: Monday, July 06, 2020, 15:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

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

“Good code is its own best documentation. As you’re about to add a comment, ask yourself, “How can I improve the code so that this comment isn’t needed?” Improve the code and then document it to make it even clearer.” 

Steve McConnell

#agenda, #meetings

Summary for Docs Team Meeting on 29th June 2020

Attendance

@kenshino, @sukafia, @chaion07, @tacitonic, @atachibana, @kenshino, @sukafia, @chaion07, @tacitonic, @atachibana, @cristiano.zanca, @glorialchemica, @wpza, @mkaz, @crstauf, @milana_cap, @fahimmurshed, @Prubhtej_9, @estelaris, @tomjn, @timohaver, @yui, @mte90, @newyorkerlaura, @bph, @collinsmbaka, @ataurr, @softservenet, @imneet94, @abutalha94, @ibdz, @manthanadmane, @themiked, @mekalekahi.

Find the Agenda of the Meeting here.

Thanks to @kenshino for Facilitating the Meeting.

Notetaker & Facilitator Selection

Notetaker: @chaion07

Facilitator for the next meeting: @chaion07

Next Meeting will be held on: 06 July 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

@atachibana informed that 1014 out of 1070 pages had been completed. Currently the project is at 94.8% completion which is a 0.80% improvement from last week. He also thanked @stevenlinx for the contribution.

@bph reported that the Bee-Docs Meetings are held every Mondays at 14:00 UTC in #meta-helphub. Meetings start with the following items for contributor check-in:

  1. What have you been working on?
  2. What do you want to work on next?
  3. What are your blockers, (apart from time and 
  4. handling any blockers.

@bph also thanked @tacitonic for his committed work with new contributors, reviewing and publishing articles. The team is currently also working on the following:

  • Documentation for 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 so all contributors know how to work in it and so that we can all track what’s going on
  • WordPress.comWordPress.com An online implementation of WordPress code that lets you immediately access a new WordPress environment to publish your content. WordPress.com is a private company owned by Automattic that hosts the largest multisite in the world. This is arguably the best place to start blogging if you have never touched WordPress before. https://wordpress.com/ documentation to fill some of our gaps and get a head start on some 5.5 features.

Categorization Project

@kenshino mentioned about @swissspidy‘s contributing to a XML Sitemap Documentation too.

@estelaris wrote a p2 post on classification and appreciated everyone who commented. The deadline for comments is set as 5 July 21:59 UTC. The team will again discuss this at the next weekly meeting on 06 July 2020. @estelaris and @ibdz will get together this week to continue with the design, leaving navigation aside until we resolve the classification.

@milana_cap is currently overseeing the work on 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 Docs for developers and she invited everyone to get involved with this tutorial prepared by @makz and it needs testing.

@makz added by saying that ‘The Create a Block’ Tutorial got merged in, but not linked up yet and still need to add Block Directory updates which you can browse on Github.

@christiano.zanca shared the news of Italian HelpHub being started. You can visit https://it.wordpress.org/support/ and experience it first hand.

External Linking Policy

@milana_cap is thinking of parts of the process as:

  • Proposal made by anyone (for external resource) – perhaps prepare a template
  • Review by Docs team members – need a list of criteria for this
  • Public post about proposal, review and reasons for acceptance/rejecting; and
  • Add resources to the public list of “Allowed resources”.

For the ‘list of requirements’ she’s thinking about the following types of resources:

  • Personal blogs
  • Tutorial sites (Udemy, Coursera, Skillshare, etc.)
  • Forums (Stack Overflow, TechRepublic, etc.)
  • Commercial blog (Not Allowed)

You can join the conversation by visiting the p2 post related to this topic. @milana_cap is considering writing another p2 post on this.

New Member Mentoring Team

@sukafia reported that the Mentoring Team is actively reaching out and checking up on new members. The team is ensuring that every member gets a Welcome Message and is provided with links to helpful resources and guidance relevant to #docs. 5 new members have joined since last week, raising the numbers for this month to 68. The ‘New Member Mentoring Team’ will be having a meeting  to discuss our next steps & ways to improve the mentorship initiative.

You can contact @sukafia, @softservenet, @tacitonic or @Prubhtej_9 with your ideas, suggestions and comments.

Monthly Coffee Break (June 2020 Updates)

We have 12 people joining in the Monthly Coffee Break for June where we have discussed informal topics and tried to understand each other. We have received positive feedback from participants so @sukafia will create another Doodle for the month of July and share it in the #docs channel. 

@chaion07 will volunteer alongside @sukafia to continue writing a monthly summary piece on the coffee break in the form of a p2 post.

Google Season of Docs

All Technical Writers who are interested to participate in the Google Season of Docs for 2020 are requested to comment in this p2 post. A lot of the mentors have their designated Google Form or other means of communication to submit their ‘expression of interest’ by the technical writers. Technical Writers are requested to follow the guidelines provided by the Mentors for their specific project idea as mentioned in the post. You can also comment in the #docs channel and tag your Mentor for faster communications if needed.

End of Meeting Notes

#meetings, #notes

Agenda for Docs Team Meeting June 29, 2020

The next meeting is scheduled with the following details:

When: Monday, June 29, 2020, 15:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

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

#agenda, #meetings

Summary of Docs Team Meeting for June 22, 2020

Attendance

@Ataurr @bph @chaion07 @collinsmbaka @estelaris @FahimMurshed @ibdz @joyously @Kenshino @Leslie @MakeWebBetter @manthanadmane @mekalekahi @milana_cap @PiyushChetwani @Prubhtej @saiftheboss7 @sasiddiqui @softservenet @sukafia @tacitonic @themiked @timohaver (23 people attending)

Agenda

For reference, you may view the meeting agenda post for 6-22-20

Note-taker: @timohaver

Notes Reviewed by: @chaion07 

Facilitator: @chaion07

Facilitator for Next Meeting: @Kenshino

Meeting Transcript: https://wordpress.slack.com/archives/C02RP4WU5/p1592838088036700

Follow the docs team meeting on the WordPress.org Slack workspace by joining the # docs channel.

Project Updates

Prior to the meeting, @atachibana reported 1006/1070 (94%) completed for 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 Reference for Functions. He recognized @stevenlinx for their collaboration processing complex cases, and @obt28 for work on 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..

@bph completed the first meeting for 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 Documentation team. The team meets again next Monday (1400 UTC) in the #meta-helphub channel. 

Categorization Project, Alterations Workflow

@estelaris has a draft post in-progress. She expects to finish it no later than Wednesday, and requested discussion and feedback as comments on the post.

External Linking Policy: Trusted Sources

@milana_cap authored a detailed post on this topic. She has been fielding questions, and this is helping to shape some early ideas about workflows. More participation is better. Everyone is invited to contribute ideas and questions as comments on the post. For updates, follow the #external-linking-policy tag.

New Member Mentor Training

@sukafia reported that 63 new members have joined the docs channel this month. The New Member Mentoring team has made follow up contact with all the new members. @sukafia thanked @tacitonic @Prubhtej, and @softservenet for their contributions to the team effort.

Monthly Coffee Breaks/Zoom Sessions

The June Coffee Break is set for this Thursday (June 25) at 1500 UTC.

Open Floor

@joyously referred to a question previously asked about the licensing “of the various docs: what is it and where is it stated”, inquiring if it was ever resolved or posted. @Kenshino answered that all docs in question were GPLv2, with permission to multi-license as-needed. He offered to create a page for the sake of clarity. The exchanges that followed weighed the merits of adding licensing content to post and page footers vs. creating a page. 

@joyously is finding the new order of DevHub sections to be less useful than the prior version. She cited a closed ticket that resulted in the change. @Kenshino is pursuing a response from @atachibana.

@manthanadmane and @softservenet inquired about creating a dedicated 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/. channel for new member mentoring. @Kenshino asked to address the question at the next weekly meeting.


Please feel welcome to suggest revisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. in the comments.

#agenda, #meetings

Agenda for Docs Team Meeting June 22, 2020

The next meeting is scheduled with the following details:

When: Monday, June 22, 2020, 15:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

  1. Attendance
  2. Note-taker & Facilitator selection (for Next Meeting)
  3. Project Updates
  4. Categorization Project, Alterations Workflow
  5. External Linking Policy– Trusted Sources
  6. New Member Mentor Training
  7. Monthly Coffee Breaks/Zoom sessions
  8. Open Floor

“All the details of life and the quirks and the friendships can be laid out for us, but the mystery of the writing will remain. No amount of documentation, however fascinating, can take us there.”

~ V. S. Naipaul

#agenda, #meetings

Summary for Docs Team Meeting: 8 June 2020

Attendance

@atachibana @bph @chaion07 @cguntur @collinsmbaka @estelaris @Femy @ibdz @kmeze @MakeWebBetter @manthanadmane @marcio-zebedeu @mkaz @Prubhtej @rbest @Ruchit @Sunday @tacitonic @timohaver @tomf
(20 people attending) 

Agenda

For reference, you may view the meeting agenda post for 6-8-20.

Note-taker: @timohaver

Notes Reviewed by: @collinsmbaka

Facilitator: @chaion07

Facilitator for Next Meeting: @collinsmbaka

Follow the docs team meeting on the WordPress.org Slack workspace by joining the # docs channel.

Project Updates

@atachibana expressed thanks to all WCEU contributors, reporting more progress for the re-routing of Codex to Code Reference for Functions: now 987 of 1070 (92.2%) complete. 

@bph extended a welcome to all new contributors to 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. Following a strong response from WCEU 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/., she is still catching up to reviewing new work. Half the work on the new contributor list has been published. The team also added more editors to make updates and correct errors. Going forward, she is transitioning team communication to the #meta-helphub channel.

@mkaz is seeking feedback for a draft version of the Create a Block tutorial in the 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.

Categorization Project, Alterations Workflow, User Stories

@estelaris 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/. post on current journey mapping on documentation. 

New Member Mentor Training

@Sunday plans to resume new contributor sessions next week, after a two week pause due to WCEU. @tomf reports that the mentoring team has been noting all the new docs team arrivals and has plans to reach out.

WCEU Contributor Day Wrap Up

This will come from @zzap who was not available for this week’s meeting. 

Monthly Coffee Breaks/Zoom sessions

@chaion07 asked everyone to participate in @Sunday‘s Doodle (online poll) to help determine the best prospective meeting times. @tomf suggested that perhaps the meeting time should alternate monthly, if there isn’t a time that is practical for everyone.

Open Floor 

Based on recent reporting about Instagram, @bph raised a copyright concern relating to the use of embed blocks. She asked for feedback for adding a general disclaimer to embed blocks’ documentation.


Please feel welcome to suggest meeting notes revisionsRevisions The WordPress revisions system stores a record of each saved draft or published update. The revision system allows you to see what changes were made in each revision by dragging a slider (or using the Next/Previous buttons). The display indicates what has changed in each revision. in the comments.

#meetings, #summary

Agenda for Docs Team Meeting June 08, 2020

The next meeting is scheduled with the following details:

When: Monday, June 8, 2020, 15:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

  1. Attendance
  2. Note-taker & Facilitator selection (for Next Meeting)
  3. Project Updates
  4. Categorization Project, Alterations Workflow, User Stories
  5. New Member Mentor Training
  6. WCEU 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/. Wrap Up
  7. Monthly Coffee Breaks/Zoom sessions
  8. Open Floor

“Good code is its own best documentation. As you’re about to add a comment, ask yourself, ‘How can I improve the code so that this comment isn’t needed?’ Improve the code and then document it to make it even clearer.” 

~ Steve McConnell

#agenda, #meetings

Summary for Docs Team Meeting: 1 June 2020

Attendance

@makewebbetter @atachibana @milana_cap @chaion07 @bph @ibdz @collinsmbaka @estelaris @timohaver @kenshino @prubhtej @tacitonic @leslie @kartiks16 @newyorkerlaura @sukafia @WPZA @ataurr @manthanadmane @thisisyeasin @audrasjb @mkaz @chetansatasiya @sovstack @tomf @kulsumsiddique @themiked @leogermani @sasiddiqui

Agenda

You can find the Agenda here.

Notetaker: @collinsmbaka

Notes Reviewed by @makewebbetter

Facilitator: @makewebbetter

Facilitator for Next Meeting: @chaion07

Follow the meeting on the Slack channel for Docs

Project Updates

@bph reported that completed tasks from contributors will be published this week. She also urged the contributors to switch over to the experience contributors worksheet and look at the tasks there. She also reported that for contributors day, there will be +/- 16 new contributor tasks and 15 experienced tasks for 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 documentation.

@themiked reported that 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 conversion and editing continues.

@sukafia reported 61 new members joined for the month.

WCEU Online Contributors Day

@milana_cap shared a list of facilitators for Contributors Day

  • @leogermani  for DevHub (developer docs)
  • @Sukafia  for onboarding and everything regarding new contributors
  • @bph for block editor end user docs
  • @atachibana for HelpHub (general end-user docs) as long as his time zone allows (Japan)

She also shared the schedule for Contributors Day

Schedule

New Member Mentor Training

@sukafia reported that Office hour was held on 28 May 2020 for new contributors and members interested in being part of contributors day. Also that 61 new members joined for May and 75 for April and March.

He also reported that they have engaged (Messaged) everyone that joined during the month of May.

External Linking Policy

@milana_cap reported that a decision has been made, and external links from trusted sources will be allowed. She also mentioned that work needs to be done on logistics and criteria of what is a trusted source.

Monthly Coffee Breaks/Zoom sessions

@sukafia shared a doodle link for everyone to vote on the date and time they find convenient for the monthly coffee breaks, encouraging more members to vote.

User Feedback: Poll on Meeting Time & Day for Docs Team

@makewebbetter mentioned as regards the poll, the majority of the responses are yes. So the meeting time will remain the same.

Open floor

@sukafia mentioned that if you’re new to the team and don’t know where to get started. The mentorship team (@sukafia, @tacitonic, @prubhtej, @tomf, @netpassprodsr) are always available to guide. @makewebbetter also mentioned that he is also available for help over 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/..

Please feel free to suggest any changes to the meeting notes by mentioning in comments!

#meetings, #summary

Agenda for Docs Team Meeting June 1, 2020

Agenda for Docs Team Meeting June 1, 2020

When: Monday, June 1 2020, 15:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

The training is nothing! The will is everything! The will to act.

– Henri Ducard in Batman Begins

#agenda, #meetings

Summary for Docs Team Meeting: 25 May 2020

Attendance

@makewebbetter @atachibana @milana_cap @chaion07 @bph @ibdz @collinsmbaka @nobnob @estelaris @crstauf @timohaver @immeet94 @kenshino @prubhtej @tacitonic @leslie @kartiks16 @pratikchauhan @cristianozanca @kulsumsiddique @newyorkerlaura @sukafia

Agenda

You can find the Agenda here.

Notetaker: @collinsmbaka

Notes Reviewed by: @makewebbetter

Facilitated by: @chaion07

Facilitator for Next Meeting: @makewebbetter

Follow the meeting on the Slack channel for Docs

Projects Updates

@atachibana reported that the re-routing of the Codex page to Code Reference functions, 959 out of 1064 (89.7%) have been completed and the remaining functions are associated with tickets or comments and are awaiting approval.

He thanked @collinsmbaka and @stevenlinx for their contributions.

@bph reported that they have 7 contributors working on 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, @makewebbetter @tacitonic @cguntur have submitted pages awaiting review.

While @dschargel @leslie @jackF @newyorkerlaura are working on the blocks they claimed.

WCEU Online Contributors Day

@milana_cap emphasized that all team reps should create lists with easy and not so easy actionable tasks for WCEU 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/.. @bph reported that she is working on a list of not so easy actionable tasks this week.

New Member Mentor Training

@sukafia reported that they will be taking advantage of WCEU Contributors Day to help onboard new members. He also announced that there will be office hours on Thursday 28th May at 15:00 – 16:00 UTC and encouraged all new members to join in so they can get the necessary guidance. 

@sukafia also called for new volunteers for the mentorship team, as they will be needing extra hands.

External Linking Policy

@milana_cap reported that they have decided to make a whitelist of allowed external resources and that a decision on what would be considered trusted and how to deal with existing links (and try to avoid removing them manually) is not yet made.

@milana_cap mentioned that applying the whitelist should be automated. She also mentioned that she will create a p2 post for everyone to share their opinions and questions as comments.

Monthly Coffee Breaks/Zoom sessions

@sukafia shared a doodle link for everyone to vote on the date and time they find convenient for the monthly coffee breaks.

Open floor

@kenshino suggested that there should be a check to see if the current meeting time is the best meeting time for the most number of people.

After deliberations and suggestions from team members, @kenshino concluded that it is best to ask if the current meeting time is convenient for most people and that someone should write a p2 post asking “If the current time is convenient or not” @chaion07 volunteered to work on that.

@kenshino also mentioned that many mentors including himself are receiving lots of messages from Technical Writers and that it will be more beneficial if all queries being answered in one place. So for this, he requested that please all Technical Writers should put all queries either on Season of Docs: Technical Writer Exploration or here in #docs

Please feel free to suggest any changes to the meeting notes by mentioning in comments!

#meetings, #summary