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 16 November 2020

Attendance

@chaion07 @kenshino @tomford @collinsmbaka @leogermani @obt28 @tacitonic @mkaz @atachibana @FahimMurshed @Veralee @hellofromtonya @justinahinon @estelaris @themiked @paaljoachim

Housekeeping

Agenda: https://make.wordpress.org/docs/2020/11/16/agenda-for-docs-team-meeting-november-16-2020
Notetaker: @justinahinon
Next Meeting: 23 November 2020
Find the meeting transcript here

Project updates

@atachibana gave an update of 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:

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.: 153 of 355 (43.1% < – 33.8%). They’re also editing each method information of class references.

@bph mentionned prior to the meeting they’ll post asynchronously a digital check-in for the documentation team.

@justinahinon posted a follow up of 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 restructuring proposal.

Meeting times

@kenshino mentionned the Doodle for the documentation team meeting time. Please fill it if you haven’t yet.

New Member Mentoring

There were no update for this item.

Coffee Break November

The next coffee break will take place on the 19th of this month at 10am UTC. Here is the link if you want to add it to your calendar: https://us02web.zoom.us/j/83074914582?pwd=RlJkMkdnbzdKODZYbENzeUpXWGF2QT09.

If you want a Google Invite for the coffee break, you can also send a private message to @estelaris 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/..

You can also find all the details in this 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: https://make.wordpress.org/docs/2020/11/16/docs-team-coffee-break-november-update.

Google Season of Docs 2020

@tacitonic made some updates about the progress on this project:

On the reclassification front, the team is still reviewing articles for content errors but have already finalized the title change. More details are in this spreadsheet: https://docs.google.com/spreadsheets/d/1_Ea2yeF5Rfy_YDk7pBRJ4rdljhMjygXFqBq8gWwhbaE/edit?usp=sharing.

The team also discussed the big problems with titles which is the use of gerunds (words ending in ‘ing, as in working, reading, etc). This discussion can be found here.

Docs Handbook and facilitating collaboration

@themiked shared last week some updates on legacy docs which @kenshino is reviewing.

@paaljoachim asked if there have been any talks about refreshing the design. As using bigger fonts gives more space and better readability.

#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

Docs Team Meeting – 28 October 2020

Attendance

@crs1138, @bph, @kenshino, @estelaris, @chaion07, @cbringmann, @Daisy, @tacitonic, @atachibana, @sukafia, @justinahinon, @collinsmbaka, @themiked

House Keeping

Agenda: Agenda for Docs Team meeting 28 October 2020 

Facilitator: @estelaris

Note-takers: @crs1138

Notes Reviewed by: @chaion07

Facilitator for the next meeting: @chaion07 

Next meeting: 2 November 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

  • @bph: 🐝-docs no project update, we will lose two pages Facebook & Instagram Embed. We will update them with the 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. Change this week.
  • @atachibana Migrating an re-routing Codex to Code reference Classes: 43 of 43 (100% < – 83.7%) 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.: 90 of 355 (25.4% < – 17.5%) by @stevenlinx, @collinsmbaka and @atachibana Note: Though we reached 100% migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. of classes, we need some improvements.
  • @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 is now fully blocked.

The team couldn’t discuss the following agenda items due to dependency on @milana_cap and others:

New Member Mentoring

@sukafia reported that:

  • 3 new people joined in the week 19-25th October 2020.
  • There’s plan for a meeting to brainstorm ways to move the team forward

Monthly Coffee Break Reminder (October 2020)

@sukafia invites everybody to the coffee break Topic: Docs team Coffee Break Time: Oct 29, 2020 11:00 UTC Join Zoom Meeting https://us02web.zoom.us/j/81733187709?pwd=WXBjbXZBdGhiSUpWMnJzK0JxRGV0dz09 Meeting ID: 817 3318 7709 Passcode: Docs

Google Season of Docs 2020

@tacitonic completed the Language and Grammar section and is currently working on the Punctuation section. @tacitonic updates his progress in the README file daily: https://github.com/WordPress/WordPress-Documentation-Style-Guide

@dmivelli provided a long list of suggestions.

Meeting Times

Discussion

Outdated Documentation

@estelaris and @kenshino suggested the following options to deal with outdated documentation pages:

  • Delete it and redirect the URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org to a similar/relevant resource (via a 301)
  • Delete it and serve a 410 status (‘gone forever’), ideally coupled with a nice template explaining to the user that the thing is gone
  • Use 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. robots tag / HTTPHTTP HTTP is an acronym for Hyper Text Transfer Protocol. HTTP is the underlying protocol used by the World Wide Web and this protocol defines how messages are formatted and transmitted, and what actions Web servers and browsers should take in response to various commands. headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. to noindex it, if we think it’s still useful to users but want to keep it out of search engines.
  • @kenshino: Setup a legacy section and move docs there that are outdated for x versions but still relevant for a good percentage of our user base?

@themiked will sum up his thoughts on how to proceed in a post and ask the community for feedback.

#meeting-notes, #summary

Consolidated Summary for Docs Team Meeting on 12 October 2020

Unfortunately we didn’t see anyone volunteering to take notes for this meeting. Which is why I decided to publish this summary as a consolidated note for the convenience of all. I wish I was made aware of the situation earlier than this.

Ahmed Chaion

Attendance

@kartiks16, @atachibana, @softservenet, @kenshino, @fahimmurshed , @sukafia, @bizanimesh, @justinahinon, @tacitonic, @estelaris, @chaion07, @bph,

Find the Agenda of the Meeting here.

Thanks to @chaion07 for Facilitating the meeting.

House Keeping

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: @softservenet

Next Meeting: 19 October 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 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:

  • 32 Classes out 43 have been completed which is an improvement of almost 7% leading to 74.4% from last week’s 67.4%, and
  • 62 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 3.1% leading to 17.5% from last week’s 14.4%.
  • @atachibana thanked @stevenlinx for the contribution.

@justinahinon provided update on 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:

@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. (asynch to the meeting)

Figure: Block Editor End User Documentation Team

She also informed that with the help of many contributors the team collectively passed the 50% milestone for pages catching up to 5.5

The team couldn’t discuss the following agenda items due to dependency on @milana_cap and others:

Q3 Update

@kenshino shared a link: https://docs.google.com/document/d/18R79xWKOBp6Hosfs7Ao2kh-lFfhP3mR-4AbR4_BbeOo/edit# containing the Q3 Update Document for everyone to collaborate. He requested the members responsible for their team to add information respectively for a collective update. This collective information will be shared as ‘Team Updates’ that is posted in Updates Blog similar to the Quarterly Updates | Q2 2020

New Member Mentoring

@softservenet provided update as following:

  • The members of the team is focusing on taking turns to onboard new contributors to the #docs Team.
  • Anyone who has recently joined the team or still looking to find ways towards their first contribution should contact a member of the ‘New Member Mentoring Team’.
  • The Team is working on improving the process with task coordination for new members.

Monthly Coffee Break Reminder (October 2020)

@sukafia provided information on this agenda item:

  • The coffee break is taking place on the 29th of October, 12:00 UTC (with a EU-friendly time).
  • Please DM @sukafia or @chaion07 to get a calendar invite.

Meeting Times

There has been a broad discussion on the meeting time that may be suitable for majority of the team members. However it has proven to be very difficult with the DST (daylight saving time) practiced in different parts of the world. Reference to the discussion: https://wordpress.slack.com/archives/C02RP4WU5/p1602518383390100

Google Season of Docs 2020

Diana Mivelli provided update as following:

  • Been reviewing HelpHub articles and titles and recommending title updates.
  • Trying to make sure article titles adhere to sentence-case capitalization style (instead of title case) and suggesting titles away from gerunds.
  • Taking note of some overlapping content/duplicate content articles accordingly.
  • Discussing the ways to managing these suggestions as they come up with @estelaris.

@tacitonic provided update too:

  • About to finish the Language and Grammar section.
  • Updated the progress in the README file daily: https://github.com/WordPress/WordPress-Documentation-Style-Guide
  • The style guide markdown importing and parsing (from 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/ to wp.org) is underway.
  • Extended the project duration from the standard length (3 months) to a long running project (5 months) upon I discussion with mentors, and found it appropriate to extend it owing to multiple factors.

Open Floor

@mkaz brought the discussion about ‘comments on Handbook‘. Reference to the discussion can be found here: https://wordpress.slack.com/archives/C02RP4WU5/p1602519419426800

@bph shared a link to the ticket in reference to the topic discussion.

#meeting-notes, #summary

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

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

Summary for Docs Team Meeting: 18 May 2020

Attendance

@makewebbetter @atachibana @mkaz @marcio-zebedeu @annezazu @milana_cap @chaion07 @bph @ibdz @collinsmbaka @nobnob @estelaris @crstauf @timohaver @immeet94  @sasiddiqui @themiked @kenshino @miss_jwo @milana_cap @shajiaabidi @shubhampalriwala @prubhtej @cbringmann @tacitonic @leslie @kartiks16 @jackF @pratikchauhan @mukesh27

Agenda

You can find the Agenda here.

Notetaker: @collinsmbaka

Notes Reviewed by: @makewebbetter and @chaion07

Facilitator: @estelaris

Facilitator for Next Meeting: @chaion07

Follow the meeting on the Slack channel for Docs

Project Updates

@atachibana reported that the re-routing of the Codex page to Code Reference functions, 949 out of 1064 (which is roughly 88.8%) have been completed. He thanked @collinsmbaka and @stevenlinx for their contributions.

@bph is collaborating with @cguntur and @tacitonic to onboard new contributors and testing instructions.

Season of Docs Update

@estelaris shared the link to Technical writer guide | Season of Docs and urged anyone interested in participating in GSoD to fill out.

@cbringmann emphasized that they had a fair amount of interest from technical writers. They also added questions as comments to the technical writer post and are requesting a response from the docs team to complete their proposal.

Other questions from technical writers [ @shubhampalriwala, @prubhtej, @tacitonic ] present during the meeting which were diligently answered by @cbringmann.

@kenshino suggested that a mid-step should be done internally. He had raised a few projects for people who didn’t have time to write, but the registered mentors could be reshuffled to choose the right project for them

@kenshino suggested that we should create a post to work this out.

@estelaris shared the link to Season of Docs Project List Idea – Make WordPress Documentation for anybody with questions on Season of Docs to read.

External links discussion and distributions

@estelaris emphasized that we need to decide whether we allow or not, external linking in WordPress documentation. She provided External Linking in Docs Policy – Make WordPress Documentation for everyone to go through.

@kenshino read through them and emphasized his general thoughts are, I quote ”in line with our general ethos of the WP project, I’d like to see us being more permissive than restrictive’’ he then suggested a few principles to guide this process as 

  • Our focus should still be on enhancing the official docs / making it complete. So it would make sense for us to encourage people to substantiate our docs with their content first.
  • If somehow that is not possible or if the external content is useful but not suitable as official information, it’s fine to add external links.
  • It should be easy for good resources to be listed: We can have trusted sources by default – I’m happy for us to just build that list as we go along.
  • It should be easy for bad resources to be removed – even if you were once trusted.
  • Curation is essential – but it does not have to be a day job.

@estelaris emphasized that we need a workflow to avoid curation becoming a day job. @kenshino replied that he hasn’t gotten that far, but agrees that we do need some sort of workflow. @milana_cap once again volunteered to work on it.

Tasks for WCEU online contributors’ day

@milana_cap emphasized that she’d like to use this post for all the WCEU contributors’ day info. And she received some information from @mkaz for Good First Issue Gutenberg

@milana_cap also urged those who plan to attend 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/. or have a question or idea should comment on that post.

@ester had provided a link for clarification of timezone of the event referring to the question of @mkaz and @milana_cap.

@milana_cap requested the Official reps of Docs Team to make lists of specific tasks and send, so she can add them to the post.

@milana_cap also provided examples of actionable tasks below,

  • Actionable task: Review these function reference pages: link, link, link, link.. and make sure escaping and internationalization are correct and in place.

@milana_cap also reminds us that anyone who wants to attend WCEU needs to register. @estelaris replied with the registration link https://2020.europe.wordcamp.org/tickets/ 

@estelaris added that they will open new tickets for contributor day, but you need to be registered for the 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. too.

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

#summary

Summary for Docs Team Meeting: 11 May 2020

Attendance

@makewebbetter @atachibana @mkaz @marcio-zebedeu @annezazu @milana_cap @chaion07 @bph @ibdz @collinsmbaka @kartiks16 @nobnob @mukesh27 @felipeloureirosantos  @wizzard_ @fahimmurshed  @ataurr @netpassprodsr @estelaris @crstauf @timohaver @immeet94 @softservenet @kulsumsiddique @thisisyeasin @sukafia @sasiddiqui @leogermani @themiked @kenshino @rabbirshad199621

Agenda

You can find the Agenda here.

Notetaker: @makewebbetter & @thisisyeasin

Notes Reviewed by: @chaion07

Facilitator: @chaion07

Facilitator for Next Meeting: @estelaris

Follow the meeting on the Slack channel for Docs

Project Updates

@leogermani provided updates async to the meeting:

  • Common APIs – migrate HTTPHTTP HTTP is an acronym for Hyper Text Transfer Protocol. HTTP is the underlying protocol used by the World Wide Web and this protocol defines how messages are formatted and transmitted, and what actions Web servers and browsers should take in response to various commands. from plugins Handbook
  • Migrate 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.
  • Organize workflows within the Handbook

@atachibana reported that for re-routing of the Codex page to Code Reference for functions, 908 out of 1064 (84.9%) have been completed. He thanked @collinsmbaka and @stevenlinx for the jump from 67.4% recorded last week.

@themiked reported 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. to single blocks continues 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 handbook and he identified a few things that don’t belong to the handbook. He also identified terminology disparities that he is tracking and trying to unify for example “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.-data” vs “metadata”.

@bph added a few more categories under “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” to the articles. Both @bph and @estelaris are collaborating with each other to complete the review process. However @estelaris believes there might not be further update for reclassification until WCEU 2020 which happens in 3 weeks.

WCEU Online Contributors Day

@milana_cap emphasized on “Getting started at a Contributor Day page to be completed by this week and asked for suggestions from new contributors as well as others. She further added by referring to the Polyglots Team where they had used cool tools in their templates such as Translation Statistics tool, Translation Consistency tool etc. @leogermani & @wizzard_ volunteered to help. (Ref)

@milana_cap also proposed for scheduling a meeting between 25 May & 3 June using 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/. for new contributors. She further added by saying that this meeting could be a great opportunity for @sukafia’s mentorship program. @estelaris pointed out that the first meeting should also be for the on-boarding of the new contributors and it is important that everyone has their own Slack account and access to Making WordPress work space. Following the first meeting there should be a second meeting on the WCEU 2020 contributors day after the opening remarks but using video. @estelaris also reminded us that the deadline for video submission for the individual “Making WordPress” teams is Thursday and it would be better if a Team RepTeam Rep A Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts. created the video. Update async to the meeting: @milana_cap had already prepared a video and shared with the team for feedback.

Update async to the meeting: @leogermani edited the page and made a comment on p2: https://make.wordpress.org/docs/2020/05/09/docs-team-preparation-for-wceu-2020-contributor-day/

@milana_cap thought that it would be good to include all the tools we are using which can be found in Workflow -> Reporting an Issue page.

Creating a task list for WCEU 2020

@milana_cap emphasized on creating task lists for both beginners and advance contributors and requested everyone to define what they want to do during the day for the project. Additionally, she will create a new 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 which would include instructions with links. Here is the action plan:

Monthly Coffee Breaks/Zoom sessions

@chaion07 reported that the docs team had their first Virtual Coffee Break with several people attending. The participants spoke about how they are coping with the quarantine and isolation and what we are doing to keep ourselves busy, @sukafia had facilitated the last Coffee Break. The coffee break would take place monthly over Zoom. @sukafia will create another doodle for everyone to participate for the scheduling and accordingly be notified through the Slack channel.

New members Mentor training

@sukafia has reached out to new members and reported that some of them would start contributing within the week. He also recommended @lvg2013 that she wants to contribute to the block editor for docs. The plan for new contributors is that they’ll contribute using Google docs and once reviewed, they’ll be given guidance for their contribution to prosper ahead.

Open Floor

@milana_cap proposed that we should officially decide on  External Linking in Docs Policy but @kenshino suggested that he will make a decision by next week after reviewing all the comments. @themiked also posed the following points async to the meeting on external linking with the following questions.

  • Who has the authority to add a link to a page?
  • Who has the authority to remove a link?
  • If I (me personally) write an article on my own site and then link to it, is that seen as a conflict?
  • Will we police the links to ensure they are still valid?
  • Will we police the links to ensure the content has not changed, such as by the result of a domain transfer?

@makewebbetter inquired why are we not writing excerptExcerpt An excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. in all articles listed inside categories such as advanced-topics and when we called excerpt in the code template of this archive page we used to call excerpt but as the excerpt field left blank so first para content will automatically be fetched.

Transcript

https://wordpress.slack.com/archives/C02RP4WU5/p1589209219221400

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

@makewebbetter

#summary

Summary for Docs Team Meeting: 4 May 2020

Attendance

@milana_cap @chaion07 @makewebbetter @estelaris @crstauf @sukafia @adamsilverstein @nobnob @ibdz @johnbillion @atachibana @bph @cbringmann @themiked @sasiddiqui @audrasjb @mukesh27 @kartiks16 @collinsmbaka @immeet94 @mkaz

Agenda

source

  1. Attendance
  2. Note-taker & Facilitator selection for Next Meeting
  3. Project Updates
  4. Categorization Project, Alterations Workflow, User Stories
  5. Handbook Revamp
  6. Season of Docs
  7. New Member Mentor Training
  8. Monthly Coffee Breaks/Zoom sessions
  9. WCEU Online Contributors Day
  10. Open Floor

Notetaker: @makewebbetter
Notes Reviewed by: @chaion07
Facilitator: @milana_cap

Facilitator for Next Meeting: @chaion07
Follow the meeting on the 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

Project Updates

@bph reported on the following: (Ref)

  • Last month was all about blocks with a “Sprint” where I contributed 6 days in a row, updated 3 pages and created 4 more.
  • Secondly, collaborated with @Pascal on the list of updated pages for the #Polyglots team to include changelog. Moreover, converted reusable blocks to regular blocks for the same team.
  • Next sprint: Wednesday through Friday.

@atachibana reported on the Re-routing of the Codex page to Code Reference for Functions with 721 out of 1064completed which is approximately 67.4%. He was happy with the improvement and considered this as a big jump from 54.5% compared to last week . He also expressed his thanks to @stevenlinx and @collinsmbaka. (Ref)

HelpHub development: @milana_cap informed Table styles patch is up, wonderful @sergey pinged, we’ll have fix soon https://meta.trac.wordpress.org/ticket/5033

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: @themiked reported plugin handbook not ready this week, although PR to fix the wpdb docs pulled from source have been merged into the next release.

Categorization Project, Alterations Workflow, User Stories

@estelaris reported that work is still in process for 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/. Updates. No further updates for this week.

Handbook Revamp

@milana_cap completed Reporting an Issue page from the Docs team Handbook.

New page to work upon while we are on workflows would be Facilitating Documentation Table at Contributor Day

Season of Docs

@cbringmann confirms regarding linking all projects to google which are listed here 

The list for Mentor Applicants are:

@cbringmann also mentioned that we have to wait for Google to get back to us, then will have a list of projects which got selected so that we can move to the next step. The Linked Project List can be found (here).

New members Mentor training

@sukafia suggested that we should have a meeting within this week for the new member’s Mentor training.  He also spoke with @atachibana and collected some ideas on how to help new members contribute to devhub as @atachibana had shared a list of projects new members can easily contribute to. 

Monthly Coffee Breaks/Zoom sessions

@sukafia had created a Doodle for coffee break and requested all of us to please select the preferred slot according to availability.

WCEU Online Contributors Day

@milana_cap has started writing a p2 post for WCEU Online 2020 Contributors Day

Open Floor

@audrasjb announced that French Documentation team had successfully translated 76 Helphub pages which actually covers 36.3% of total, now moving forward to make those pages publicly available for all French users. He also expressed his gratitude to everyone who worked on HelpHub internationalization and thinks that it was fantastic.

@milana_cap urged one of the Docs Team members to maintain the developer’s 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 documentation. She also added by saying if you’re knowledgeable and experienced with developing on top of the block editor then you should try and help. @makewebbetter offered to help and @milana_cap would look after it.

#meetings, #summary