Summary for Docs Team Meeting on March 1, 2021

Attendance

@chaion07 @ashiquzzaman @justinahinon @bph @zzap @tacitonic @atachibana @geheren @reachmazharul @harishanker @themiked @deadpool76 @atiktonmoy

Housekeeping

Project Updates

HelpHub Redesign

Update from @estelarisThere are no updates on the HelpHub redesign project yet but estelaris still need help with articles link review. All the articles must be reviewed, most are fine and few are not, and those few are the cause of plenty of fix-link requests. If anyone wants to review, 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.” @estelaris. The task is only to identify the wrong links and there is a team in charge of approving and updating the links. @ashiquzzaman showed interest to review the articles

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 Developer Doc

Update from @justinahinon – The table of content pull request (https://github.com/WordPress/gutenberg/pull/28665) is ready to be merged.

End User Block Editor team

Update from @bph  –
@geheren and Mathew McCabe had their sprint; @poena had also participated. Discussed the end-user documentation for Full Site Editing. The plan is to wait until the Prototype is released, and then again until 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. of 5.8 to see what will make it into coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.. WP 5.7 changes are now available in our Spreadsheet and 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. 

The team is also getting ready to touch almost all pages to implement More Options link/page enable comments and add a note to the change-log as with which WordPress version a page is currently. @Geheren added that to all the pages in the Trello board. Once @collinsmbaka publishes his page, all contributors can start working on it. A plan is in place to welcome new contributors to the team.

Full Site Editing Documentation

Skipped for this meeting.

Codex to HelpHub MigrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies.

@atachibana was unavailable to provide an update on this.

New Member Monitoring

@chaion07 reported that 10 new members joined the Docs channel in the past 7 days. The team welcomed all of them. Here is the Slack thread with the list of members.

Monthly Coffee Break

There is a new p2 you can all check out: Docs Team Coffee Break February 2021 Summary.

@chaion07 reported that there have been a total of 5 contributors joining in for February 2021 Coffee Break. Thanks to @thisisyeasin, @Gtarafdarr, @atiktonmoy & @reachmazharul for making time. For those who couldn’t make it you can definitely join the March Coffee Break. Anyone who is willing to host it can ping either @chaion07 or @sukafia

Google Season of Docs

Update from @tacitonic:
Completed 15/28 articles in the Word list and usage dictionary. Parser will be completed by Monday, i.e. today. The project finalization phase for Google Season of Docs begins from today. He’ll start writing 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/. on make.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//docs after the final project report. Google Season of Docs 2021: The organization application phase has also begun for this year’s program.

Open Floor

The team discussed using 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/ as opposed to other tools, as GitHub would also reduce the use of Trello to some extent. 

#meeting-notes, #meetings, #summary

Summary for Docs Team Meeting: January 25, 2021

Attendance

@crstauf, @milana_cap, @chaion07, @tacitonic, @atachibana, @estelaris, @paaljoachim, @themiked, @clorith, @austinsangs, @justinahinon, @collinsmbaka, @clorith, @reachmazharul, @mdmamun-1, @snilesh, @habib919000, @ashiquzzaman.

Thanks to @chaion07 for facilitating the meeting.

Housekeeping

Agenda: https://make.wordpress.org/docs/2021/01/25/agenda-for-docs-team-meeting-january-25-2021/

Notetaker: @austinsangs

Notes Reviewed by: @chaion07

Facilitator for the next meeting: @milana_cap

Next Meeting: 01 February 2021

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

Team Goals for Q1 2021

@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 goals are done.

@milana_cap suggested that all reps for different projects make sure that their projects are added in the Team Goals for Q1 2021 document. This should become a regular practice to have goals listed in our handbook as it’s easier to keep track with projects and contributors can see the progress.

@estelaris updated her project goals and will have and will have the first post ready for review before publishing.

@crstauf posted their goals as follows:

  • stay on top of pending user notes: check twice per day.
  • optimize process for handling feedback for doc changes.

Project Updates

  • Obsolete P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. Docs: @themiked suggested that obsolete P2 docs will stay in their place, wrapped with something to indicate their absoluteness. To use the red Warning box short-code along with some phrasing that everyone will then want to modify, but it’s easier to edit than create so that’ll move things along faster. 
  • User Notes: @cstauf mentioned that before the weekend there were no pending user notes. There are however 16 entries for feedback to docs changes that @audrasjb has indicated that he will handle.
  • Migrating from Codex to HelpHub: Content team is 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.. 296 out of 355 are completed (83.4% from 80.3% from last week). He thanked @stevenlinx like always.
  • BEE-Docs: @bph posted an update asynchronous to the meeting that the team is making headway page updates after 5.6 release Thanks to @cguntur @bizanimesh @geheren @collinsmbaka. She also thanked @incapit, Tom Rankin and @MathewMcCabe for joining the team and collaborating on updates.
  1. New pages needed    6
  2. WordPress 5.6    44
  3. WordPress 5.5    14
  4. WordPress 5.4    3
  5. WordPress 5.3    2
  6. WordPress 5.0    9
  7. Pre WordPress 5.0    3
  8. The will schedule a team sprint for the first week in February to discuss task list for 5.7 @geheren and I are working on triaging the issues from 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/ Changelogs 9.3 – 9.9
Figure: BEE-Docs Update

New Member Mentoring

7 new members joined #docs in the week between 16 and 23 November 2020. The mentoring team is contacting the new members. The process is a little slow due to the unavailability of many members who are still not back from their holidays and we can definitely understand that. The mentoring team continues to maintain the process and always appreciate the new members who respond to our messages. Thanks to @chaion7 for the information. He also thanked @sukafia, @tacitonic, @Prubhtej_9, @tomf @MathewMcCabe for continuing the good work.

Monthly Coffee Break Announcement (January 2021)

The first coffee break for 2021 is set to take place on the 28th of January.

@chaion07 will be hosting this coffee break at 3 PM UTC. Details to be posted in  P2.

Google Season of Docs

@tacitonic reported on the following:

  • Almost completed the Developer Content section.
  • The only other section remaining is the A-Z word list/Glossary.
  • Encouraged team members to review and discuss articles in the discussion tab on the repo.

@tacitonic mentioned that as the project deadline is approaching, it would be great if we could get the 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 parser implemented, which would give me some time to work with  errors/issues if any.

Open Floor

@corith referred to a previous message as a reminder posted in the #meta channels: https://wordpress.slack.com/archives/C02RP4WU5/p1610575528265400 @milana_cap acknowledged the topic and added it to her list. She also mentioned of pinging @kenshino about this.

#meeting-notes, #meetings, #summary

Summary for Docs Team Meeting on 11 January 2021

Attendance

@milana_cap, @estelaris, @paaljoachim, @atachibana, @tacitonic, @shitalmarakana @chaion07, @bph, @justinahinon, @aurangajeb, @themiked

Thanks to @milana_cap for Facilitating the Meeting.

Notetaker & Facilitator Selection
Project Updates
  • 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 by @themiked: Minimal changes, need to ratify the external linking policy document. According to Mike, all previous owners have just made changes as appropriate without asking, and nobody noticed.
  • Design for Documentation by @estelaris: Planning on finishing the design for documentation in the first quarter. Need to gather the final results from the reclassification project, other requirements I picked up from diverse meetings and put together my recommendation for final design. You will see a few discussion posts before the design proposal, aimed between the last week of March- first week of April.
  • BEE-Docs by @bph: Caught up on our articles to make them current with 5.5 and started working on 5.6 updates and create new pages. Started to open up the feedback for more pages. Definitely need instructions, how we would like to handle things. The team is now working via 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., Google Docs. Kudos to all who keep working away on the to-do lists. The ‘Thanksgiving Sprint’ which was a great way to get a lot of things done and connect with contributors, especially new ones. This will definitely be repeated and hopefully can be an ongoing team exercise. Kudos to @geheren for taking up a quite a few pages and work on them.Challenges: We don’t yet have a fluid system on keeping pace with the rapid development 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/ and for adoption of FSE for 2021 the team needs help from the coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.-editor team to at least have a rough draft of documentation coming from the developers, that we can follow and extend for End-User.
  • External Linking Policy by @milana_cap: Finally made some visible progress even though it was rather slow at the beginning
  • Google Season of Docs by @estelaris: One project finished and another is due to finish by Q1 2021 by @tacitonic. He finished the lengthiest section in the style guide – the Formatting section, started writing a spinoff section on Linking and encouraged team members to review and discuss articles in discussion tab 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/.
Goals for Next Quarter

Milana thinks that The Team can start with some rough ideas where each project should be in March. Not just projects but processes as well. Plugin Handbook should finish the second phase: https://make.wordpress.org/docs/2020/12/01/external-linking-policy-1st-review-of-plugin-developer-handbook/ The main idea here is to think about direction for each project and some sort of measurable progress at the end of each period.

It’s Birgit’s first year on the team, so she’s not sure what’s the ‘usual’ process is. On Community team, there is a post asking for suggestions from the whole community, like the wishlist for the new release and then the team organizes the suggestions and translate them to goal statements, and picks their priorities.

Estela points out the goals for Design: Documentation design proposal – Q1

  • 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/. new requests – Week 03
  • P2 new classification – Week 05
  • P2 on final navigation – Week 07
  • P2 on templates draft – Week 10
  • P2 proposal new design for documentation – Week 13
Open Floor

@estelaris feared to collaborate with the #meta team but at the same time is planning to annoy them until they reply. @bph mentioned that #Meta team is working on a Pattern Directory that is exciting for a lot of us.

@tacitonic was looking at ways to insert an icon inline to indicate that a link is going to an external site. Reference: https://developers.google.com/style/cross-references#out-page

#meeting-notes, #meetings, #summary

Summary for Docs Team Meeting on 23 November 2020

Attendance

@estelaris, @chaion07, @bph, @harishanker, @tacitonic, @veralee, @justinahinon, @paaljoachim, @cguntur

Thanks to @estelaris for facilitating the meeting.

Housekeeping
Project Updates

@bph is planning to do a guided documentation sprint for the BEE-Docs starting this Wednesday through Friday (25 to 28 November). The extensive list of the changes in WordPress 5.6 that needs to be triaged and categorized, compared to the current pages and transformed into a contributor task list. Birgit will be online every morning 9 to noon EST. Please join her at your convenience during these times and contribute to BEE-Docs. Birgit will be posting an announcement p2 later on.

@justinahinon is collaborating with @paaljoachim for 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 in order to improve it. Justin hinted that there might be a bit more progress than the past weeks.

New Member Mentoring

6 new members joined #docs in the week between 16 and 23 November 2020. Thanks to @prubhtej for the information.

Meeting Times

Due to the general confusion with the time-zones a new Doodle was created by @kenshino. Everyone is requested to cast their votes.

Monthly Coffee Break

The November Coffee Break was hosted by @estelaris with 5 participants joining. @chaion07 will be posting a summary in a p2 later on.

Google Season of Docs 2020

@tacitonic is reported the following:

@estelaris mentioned that the classification project will start reviewing 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. articles and coordinate with the BEE-docs team to figure out how to move forward.

The GSoD team would love to hear from the Docs team on the Do’s and Dont’s including comments related to the Style and Tone section.

Open Floor

@bph informed everyone that we need to enable discussion per page since the feedback section that’s now available on HelpHub. Users will be able to leave comments for the Admins and Moderators to be able to view them using wp-admin. Also in the works is a way to revise an article without taking the existing page offline or update unfinished. We will be able to work on 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. and then schedule making them public.

@paaljoachim asked if there been any talk about going through the structure of the handbooks and suggested that creating a flow chart of how docs are linked together can help improve on the user experience. @estelaris mentioned that there has been discussion on this in the past and advised everyone that any idea or a proposal on the topic is welcome. Paal will be bringing this topic next week since majority of the team is unavailable for this meeting.

#meeting-notes, #meetings, #summary

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