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

Docs Team Coffee Break February 2021 Summary

The February Coffee Break took place on the 24th instant at 11 AM UTC timing which saw the presence of 5 contributors from the Global Documentation Team. Kudos to @chaion07 for hosting!

Docs Team Coffee Break for February 2020

I came online at the scheduled time but did not see anyone joining. So I waited and sent a message across my workplace, weDevs which resulted in a few of my colleagues joining instantly.

We mostly talked about how to become a Documentation Contributor and what projects are there to contribute. I tried to answer various questions ranging from the Handbook to the weekly meeting. All contributors were encouraged to attend the weekly meetings.

We thank @atiktonmoy, @thisisyeasin, @reachmazharul & @gtarafdarr for joining the Docs Team Coffee Break for 2021. We invite all of you to join the coffee break for March 2021 as it progresses from planning to execution.

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

Agenda for Docs Team Meeting March 01, 2021

The next meeting for the Make WordPress Global Documentation Team is scheduled with the following details:

When: Monday, March 01, 2021, 14:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

  1. Project Updates
  2. Full Site Editing Documentation
  3. New Member Mentoring
  4. Monthly Coffee Break
  5. Google Season of Docs
  6. Open Floor

Please feel free to suggest agenda items by commenting on this post or raise during the open floor.

Thank you!

#agenda, #meetings

February 2021 Docs Team Coffee Break Announcement

The next Coffee Break for Docs Team is scheduled for Thursday, February 25, 2021, 11:00 UTC. The details for joining the Zoom call are as follows:

The details will also be posted in #docs channel on the day. If you wish to get a calendar invite then 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.” @chaion07 or @sukafia. Take care and stay safe!

#coffee-break, #meetings

Summary of Docs Team Virtual Coffee Break: January 2021

The virtual coffee break for January happened on the 29th instant from 15:00 UTC to 15:30 UTC as per schedule. I facilitated the session with only Estela Rueda answering the call. We understand the fact that a lot of our regular contributors aren’t back from holidays yet and as the second wave of COVID is emerging in different parts of the world it is becoming a lot difficult that we can imagine for contributors to join in.

During the session we had a casual discussion about our lives and we tried to reflect on the collaborations that we contributed to during last year. We talked about family and friends including our journey for the documentation regarding the projects that we are working on. Personally it was great for me to receive first-hand advice from Estela about contributing to open sourceOpen Source Open Source denotes software for which the original source code is made freely available and may be redistributed and modified. Open Source **must be** delivered via a licensing model, see GPL. and WordPress.

P.S. Even though Estela asked me not to write a p2 or post screenshots from our virtual coffee break, I thought it would be a good practice to continue with the tradition of having an update for the team. I hope she won’t mind. Thank you all and stay safe!

#coffee-break, #meetings

Docs Team Monthly Virtual Coffee Break: January 2021

What is a Virtual Coffee Break

Coffee Breaks are informal discussions taking place in a Zoom call for 30 minutes among regular and new contributors to the Make WordPress Docs Team. We have an ongoing agenda which can be traced back to the most recent meeting summary to help facilitate the process. Currently @sukafia and @chaion07 are volunteering to take care of the responsibilities. We’ve also had @estelaris hosting one the coffee break for November last year. Join the next coffee break and express your interest should you wish to host one in the coming months.

What happens in a Coffee Break?

Contributors engage in casual and fun conversations in a safe virtual environment. We ask ice breaker questions to build rapport among each other that have resulted in a better sense of understanding with each other amidst the global pandemic that we are facing currently. Now is the time to support our contributors more than ever and the coffee break creates a difference simply by creating a scope and opportunity to hear one another out. You can join in and hang out with fellow contributors to the Make WordPress Global Documentation Team.

Past Coffee Breaks

We have a few summary dedicated to the coffee break sessions. Here are some examples:

January 2021 Coffee Break Reminder

The next Coffee Break for Docs Team is scheduled for 28 January, Thursday at 15:00 UTC. The details for joining the Zoom call are as follows:

The details will also be posted in #docs channel on the day. If you wish to get a calendar invite then 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.” @chaion07. Take care and stay safe!

#coffee-break, #meetings

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

Agenda for Docs Team Meeting January 25, 2021

The next meeting is scheduled with the following details:

When: Monday, January 25, 2021, 14:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

  1. Team Goals for Q1 2021
  2. Project Updates
  3. New Member Mentoring
  4. Monthly Coffee Break Announcement (January 2021)
  5. Google Season of Docs
  6. Open Floor

Please feel free to suggest agenda items by commenting on this post or raise during open floor. Thank you!

#agenda, #meetings

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

Agenda for Docs Team Meeting January 18, 2021

The next meeting is scheduled with the following details:

When: Monday, January 25, 2021, 14:00 UTC
Where: #docs channel on Slack.

Meeting Agenda

  1. Housekeeping
  2. Project Updates
  3. New Member Mentoring
  4. Monthly Coffee Break January 2021
  5. Open Floor

#agenda, #meetings