Justin Ahinon 11:30 am on November 30, 2020
Tags: ,   

Gutenberg developer documentation – Zoom meeting agenda

In a previous post, we shared a Doodle link to choose times to attend a Zoom meeting on 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.

The selected date for the meeting is: 

Wednesday, December 02, 2020, 08:00 UTC

Zoom link: https://us04web.zoom.us/j/79656401480?pwd=cXZ1U2t2MjFYQUFrQ3EwMzRLYW93UT09

Topic: WordPress Documentation Team - Gutenberg Developer Documentation

Join Zoom meeting:
https://us04web.zoom.us/j/79656401480?pwd=cXZ1U2t2MjFYQUFrQ3EwMzRLYW93UT09

Meeting ID : 796 5640 1480
Passcode : 9xHGhA

If you want to participate in the meeting, please read the initial restructuring proposal and the follow up post if you need more context.

Agenda

  • Introduction to the Gutenberg developer documentation restructuring proposal
  • Review of the current structure of the documentation (@paaljoachim)
  • Review of documentation use cases
  • Discussion on adjustments to be made to the documentation and next steps to move the project forward
  • Open floor

If you have others items that you would like to be discussed at the meeting, please comment on them in this post.

#block-editor, #developer-documentation

Ahmed Chaion 9:25 am on November 30, 2020
Tags:   

Docs Team Coffee Break November Summary!

The October Coffee Break took place on the 19th instant with at 10 AM UTC timing which saw the presence of 5 contributors from the Global Documentation Team. Kudos to @estelaris for hosting!

Docs Team Coffee Break for November 2020

We talked about our professional life and where are we located. There were a few hypothetical questions that was asked which brought an instant smile to all of our faces.

Answering questions about our lives

I had the pleasure to put my online photography skills to test that I acquired through volunteering for 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. Europe online 2020 by capturing a few virtual selfies with permission from the participants. Thanks to @estelaris, @chaion07, @sukafia, @tacitonic & @kafleg for joining us.

The details and other information regarding the Coffee Break for December will be discussed during the Weekly Meeting for 30 November 2020. If you are interested to host the next coffee break then please let us know.

Thank you!

#coffee-break

Ahmed Chaion 8:48 am on November 30, 2020
Tags: , ,   

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

Justin Ahinon 3:30 pm on November 26, 2020
Tags: , core-js,   

Gutenberg developer documentation – Doodle for a meeting

This post proposes a meeting to go through the current structure of 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 and discuss its information architecture.

A few months ago, I made a proposal to restructure the Gutenberg developer documentation. With the #core-js team, we then worked to identify the use cases of this documentation.

But there are still some points in relation to this documentation and the proposal that need to be clarified. It would be interesting to discuss this in a video meeting with interested people.

Here is the a Doodle link to choose the slots that suit your schedule for next week to participate in the meeting: https://doodle.com/poll/f4zpukgkhit92vdi.

Please read the initial restructuring proposal and the follow up post if you need more context.

The detailed agenda for the meeting is coming soon.

#block-editor, #developer-documentation

Birgit Pauli-Haack 3:01 pm on November 24, 2020
Tags: meta-helbhub,   

Block Editor Documentation Sprint for HelpHub Nov 25 – 27.

The 🐝 – docs (Block Editor End user) team will hold a “Documentation Sprint” on Wednesday, November 25 through Friday, November 27, 2020. There will be permanent presence in the #meta-helphub channel from 9 am – noon EST as well as Zoom office hours (see schedule below).

Dedicating a focused time slot on each of the three days, should give us enough momentum to check in with existing contributors and onboard new contributors. We also should get a head start on updating the documentation to WordPress 5.6 and close some gaps that we still have in our End-User documentation.

Kick-off is on Wednesday 25th at 9am EST in #meta-helphub.  We will begin with a discussion and the preparation of a Google Sheets docs task list from this raw list of relevant updates: one for new contributors, one for experienced contributors.

Updates will be published in the #meta-helphub channel on SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/..

Once the lists are prepared, contributors can sign-up for tasks, and if they are not yet familiar with our processes we will be there to help them get started.

If you are an experienced contributor and already have existing commitments via the TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the make.wordpress.com/marketing team uses for example: https://trello.com/b/8UGHVBu8/wp-marketing. board, we hope you can dedicate some time to finish your assignment or let us know about your blockers, so we can assist you.

Please take the opportunity to test the blocks and features with the WordPress 5.6 RCRelease Candidate A beta version of software with the potential to be a final product, which is ready to release unless significant bugs emerge. via the WordPress Beta Tester plugin, and include relevant changes and screenshots of the new version.

Zoom office hours schedule

Contributors will be holding office hours on Zoom for questions, reviews and discussion. Sometimes it is much easier to discuss something face-to-face or if demos are needed.

  • Wednesday, Nov. 25, 2020
    • 10 am EST (15:00 UTC) – 10:50 EST (15:50 UTC)
    • 11 am EST (16:00 UTC) – 11:50 EST (16:00 UTC)
  • Thursday, Nov. 26, 2020
    • 10 am EST (15:00 UTC) – 10:50 EST (15:50 UTC)
    • 11 am EST (16:00 UTC) – 11:50 EST (16:00 UTC)
  • Friday, Nov. 27, 2020
    • 10 am EST (15:00 UTC) – 10:50 EST (15:50 UTC)
    • 11 am EST (16:00 UTC) – 11:50 EST (16:00 UTC)

Other Timezones

Outside those times, we are answering questions and have discussions in the #meta-helbhub Slack channel.

If contributors in other times zones are available to be present in #meta-helphub channel or on Zoom on these three days, please comment on the post here with the time windows. It would be great if we can cover more time zones.

How to get in contact

Please comment on this post if you are able to dedicate some time during the next three days and join us on this 🐝- – docs catch-up sprint.

  • Comment with your questions, ideas and commitments below,
  • Join me (Birgit Pauli-Haack) at the first office hour Wednesday 10 am EST – 15:00 UTC on Zoom (link will be posted in the #meta-helphub channel or
  • 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.” me on WP Slack #meta-helphub.

CU Y’all there!

Thank you to @tacitonic and Laura Byrne for their review for clarity and grammar.

Ahmed Chaion 2:16 pm on November 19, 2020
Tags: , , ,   

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

Justin Ahinon 2:52 pm on November 18, 2020
Tags: , ,   

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

Ahmed Chaion 7:37 pm on November 16, 2020
Tags: ,   

Docs Team Coffee Break November Update!

Hello Folks,

As we inch closer to a second wave of COVID, it has become more important than ever to stand next to our fellow contributors. The idea of having a monthly informal discussion in the form of a ‘Virtual Coffee Break’ experience is something we are finding rather helpful while trying to maintain proper social distancing. Even though we would hope for majority of our fellow contributors to join in and support the same concept it may not always be the case. Understanding this, the team came up with the idea of rotation in the timing to serve multiple time zones. Additionally, we expect to write a dedicated p2 post with the information covering the Docs Team Coffee Break.

October Coffee Break Summary

Coffee Break began with a smile!

The October Coffee Break took place on the 29th instant with a EU-friendly timing which saw the presence of 7 contributors from the Global Documentation Team. Kudos to @sukafia for facilitating it. @chaion07 @crs1138, @tacitonic & @thisisyeasin were among the ones who joined in.

November Coffee Break Reminder

The next Coffee Break for Docs Team is scheduled for 19 November, Thursday at 10 AM UTC. @estelaris will be facilitating this month’s Coffee Break. 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.” @estelaris, @sukafia or @chaion07.

#coffee-break, #meeting

Jon (Kenshino) 2:58 pm on November 16, 2020  

Agenda for Docs Team Meeting November 16, 2020

The next meeting is scheduled with the following details:

When: Monday, November 16, 2020, 15:00 UTC

Where: #docs channel on Slack.

Meeting Agenda

  1. Project Updates
  2. Meeting Times
  3. New Member Mentoring
  4. Coffee Break November?
  5. Google Season of Docs 2020
  6. Docs Handbook and facilitating collaboration
  7. Discussion: What to do with articles/pages that contain information that is no longer relevant or deprecated?
  8. Open Floor
Jon (Kenshino) 5:48 am on November 16, 2020  

Doodle for best Docs Team meeting time

Hello all,

I’d love for everyone to fill in their preference for a good meeting time. We’ve been struggling with new schedules, DST and the likes.

I’ve deliberately kept it at Monday and simply extended the possible overlap period that might give a chance for EMEA, APAC and US to meet.

We might in the future split to 2 calls but I’m hoping to start that discussion when we’re through the COVID period and people are maybe returning to offices which affects their schedule.

The doodle is here https://doodle.com/poll/it4m9bf24q92she6

I’m also aware there was an earlier doodle and would like to apologise, it wasn’t clear to us if people voted with their local time in mind or made conversions with UTC.

This doodle comes with local timing – (you can change it of course) so please vote. I’ll tally before our next meeting on 23 Nov and ratify the new meeting timing then!