Tag Archives: docs

Michael Burridge 2:45 pm on January 12, 2022
Tags: docs   

Summary of Docs Team Meeting Jan 11, 2022

Attendance

@milana_cap, @daisyo, @atachibana, @kafleg, @mburridge, @estelaris, @jdy68, @wizzard_, @utz119, @juanmaguitar, @mitchblue006, @femkreations, @kenshino, @sukafia

Housekeeping

Project Updates

A full transcript can be found in the #docs channel in the Making WordPress 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/.

  • HelpHub content
    • thanks to @annezazu, HelpHub is getting new pages relating to V5.9. Those pages will be translated via #polyglots team.
    • @atachibana highlighted the need for auto-changelog – this is a topic for future discussion.
    • future plans: re-design of HelpHub, adding TOC or index into side bar area – however global design changes are coming.
  • 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 docs
    • currently without lead in case anyone wants to volunteer.
    • a large amount of work is still outstanding here, tasks need to be moved from 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. to 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/ while filtering out what’s no longer relevant and keeping what is still relevant.
    • @milana_cap will start working on that this week and allocate some time each week until a new lead volunteers to own the project and can then continue the work themselves.
    • @atachibana will also help with this.
    • @jdy68 expressed interest in helping.
  • HelpHub feedback curating
    • currently without lead in case anyone wants to volunteer.
    • comments are coming in but someone is needed to curate them, filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. out the spam and support and move the relevant ones to GitHub.
    • @esteleris has been helping out.
    • if anyone wants to be responsible for managing these comments, @milana_cap is willing to explain everything in detail.
  • 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
    • future plans: needs to be updated with the style guide.
    • it has been “blockified” already but still needs external linking.
    • @themiked plans to create a plugin which will form the basis for a progressive tutorial – this is still in the preliminary stages.
  • Theme handbook
    • in addition, some typos, old links, and other minor things have been updated.
    • @milana_cap asked whether there is any content on converting a classic theme into a block based theme, but @kafleg reports that content on block themes has not been started on yet. There are, however, plans to create a list of topics.
  • Common APIs handbook
    • @milana_cap stated that she has ideas for this one and will create a GitHub issue for it.
  • Reference handbook – curating user contributed notes
    • there are currently 38 pending comments.
    • 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.” @milana_cap  if help is needed on this.
  • Docs team handbook
    • there’s a requirement to go through this handbook and see what’s missing/outdated/etc…
  • Onboarding 
    • @sukafia acknowledges that this has been on hold for a while. Previous work will be reviewed and next steps decided on.
  • Coffee breaks
    • @sukafia acknowledges that this has been on hold for a while. Previous work will be reviewed and next steps decided on.
  • Design
    • WP.org is getting a full redesign, @estelaris now has access to the style guide and will change the previous design of HelpHub and hopes to present the new redesign at WCEU.

The following projects were not addressed, either because the lead was not present or because we ran out of time.

Would the leads of those project please reply in comments on the agenda, thanks.

mitchblue006 9:31 am on November 10, 2021
Tags: docs,   

Summary for Docs Team Meeting November 9, 2021

Attendance

@milana_cap @mkaz @juanmaguitar @chaion07 @muhammadfaizanhaidar @kafleg @atachibana @mitchblue006

Housekeeping

Find the complete Transcript of the meeting on Slack.

Please note: Next week (16.11.2021) shall be  “Issues Triage Meeting” and thereafter (23.11.2021) “Docs Team Meeting”.

@chaion07 will facilitate this meeting and the agenda will be revision of projects that were put on hold.

Project Updates

5.9 Release (Documentation)

@mkaz is the Docs Lead for WP 5.9 https://github.com/orgs/WordPress/projects/11/. Integration of custom spreadsheets may be used for future releases as default. 

@mkaz made “Doc Type” properties to filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. by Dev Note, User Docs, or Dev Docs.

Additional help welcome as @audrasjb  @milana_cap @annezazu are also working on this release.

@milana_cap also mentioned today is feature freeze, and closed tracTrac Trac is the place where contributors create issues for bugs or feature requests much like GitHub.https://core.trac.wordpress.org/. tickets as well as planning in writing docs should be considered.@mkaz is the go to regarding this.

Open Floor

@muhammadfaizanhaidar  is awaiting response with https://github.com/WordPress/Documentation-Issue-Tracker/issues/47, @milana_cap suggested waiting for @estelaris to respond.

@milana_cap mentioned that content from Themes handbook could be combined and updated https://developer.wordpress.org/themes/theme-security/using-nonces/.

#meeting-notes

#docs, #meetings

JuanMa Garrido 11:03 am on October 27, 2021
Tags: docs,   

Summary for Docs Team Meeting October 26, 2021

Attendance

@kenshino @mkaz @mburridge @juanmaguitar @chaion07 @ashiquzzaman @donaldwmoorejr @muhammadfaizanhaidar @kafleg @atachibana @femkreations @sasiddiqui

Housekeeping

Find the complete Transcript of the meeting on Slack.

Open Floor

5.9 Release (Documentation)

@mkaz will be the Docs Lead for WP 5.9 with help from @audrasjb and @zzap on coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. docs, and @annezazu for user docs

@femkreations @mburridge offered to help with these docs

Design refresh for Org sites

@mkaz comments the 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. team is working on a design refresh for Org sites starting with /News, see work-in-progress here: https://wordpress.org/news-test/

They are building them as 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. themes, with the idea of other handbooks would be child themes off them.

Licensing Legal Text

 @chaion07 comments a few weeks back we were discussing on Licensing Legal Text with Josepha to assist us (saw this in the #team-reps channel)

@kenshino says the text is expected to be with the lawyers this week because 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/ docs are also on WordPress.org, it makes things slightly more complicated

The main issue is that general contents are CC0 and code is GP, but Gutenberg is also dual-licensed – GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. + MIT, so this info has been passed to the lawyers for them to sort out

#meeting-notes

#docs, #meetings

Milana Cap 2:31 pm on September 15, 2021
Tags: docs   

[Announcement] New workflow for reporting documentation issues

For a few weeks now Documentation team is testing out new workflow for reporting issues – a GitHub repository which will be a single, centralised place for reporting all documentation issues. How and why we decided to do this can be found in team’s meeting notes.

What we hope to achieve with this workflow:

  • Easier contribution in form of reporting issues – even though this workflow still requires another account from contributor (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/ one), with this workflow contributor doesn’t need to know which part of documentation is issue for. They can just report the issue and move on, if they so wish. We lost many one-time contributions due to the complicated workflow for reporting issues.
  • Easier contribution in form of fixing issues – with all projects and their different reporting issues tools, contributor who wanted to join team and work on fixing issues had to decide which project they wanted to work on before even seeing issues. With everything in one place they can browse all the issues, find the ones that seem interesting and then look for advice on fixing it.
  • Some projects didn’t have any way for reporting issues except for coming to #docs 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 and hoping that someone will see it. This way is deprived of a place where the issue would be discussed as many things get lost in Slack noise. Also, this way is almost impossible to keep track of contributors and give them credits for their contributions.
  • Easier managing of projects and documentation in whole – team members have better overview of everything that’s happening in every Docs project, can help out in projects they usually don’t work on and have a general picture of WordPress documentation as a whole.
  • Easier contributions tracking – with every issue, comment, contribution being saved in one place, we have a better understanding of how certain parts of docs were created and who worked on them.
  • Better planning and setting goals with GitHub projects.
  • Better understating and following progress and statistics for each project by structured labeling system.
GitHub issue discussion.
GitHub issue discussion

We are still configuring labels, templates and the repo itself; and still figuring out the best way to work on/with issues. For the future we hope to connect this repository with the actual documentation at 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/ so that contributions can be make directly on the page with the issue which would automatically create new issue and apply proper labels.

In the next phase, which will be soon, we will start using GitHub Projects for managing all the issues.

GitHub Project board for managing all GitHub issues from the repository.
GitHub Projects board

Documentation Team is managing all documentation as an unified project and is adopting appropriate tools in order to do so.

As always, if you have any questions or suggestions, please leave the in comments bellow.

Casey Milne 3:53 pm on June 22, 2021
Tags: docs, , , , train,   

Summary for Docs Team Meeting June 22, 2021

Attendance

@milana_cap, @courane01, @kmhazari, @chaion07, @femKreations, @tacitonic, @atachibana, @mehbubrashid, @ramthas, @kenshino, @mehbubrashid, @caseymilne, @deadpool76, @piermario, @estelaris, @collinsmbaka, @mburridge, @kafleg, @daisyo, @ahmedriyadh, @themiked

Housekeeping

Where: #docs channel on Slack
Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @milana_cap

Note Taker: @caseymilne

Next Meeting Facilitator: No volunteers found for facilitation of next weeks meeting. Volunteer over #docs 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/. if you can do this.

Project Updates

Proposal Update: An audit tool for Learn

Update provided from @courane01. No deadline set at the moment. Proposal gaining interest from team leaders, Learn/Training team will see a few new contributors from Automattic. Importance of streamlining auditing for teams mentioned, new Instructional Designers that are on-boarding at Learn. 

Discussion about revision management and the importance of tracking changes. Some questions from facilitator @milana_cap about existing tools used in editing workflow. 

Plans to continue collaboration between #docs and #train on this proposal, to set to write up docs needs in two weeks time, and have a video chat to discuss further.

5.8 Release

  • Today we’re entering 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. 3 phase. 
  • By the next Tuesday (when RC1 is starting) we’ll have all dev notes and field guide published
  • After that we start working on DevHub and HelpHub updates

Volunteers: anyone wants to help with DevHub, 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.” @milana_cap over Slack #docs.

@atachibana shares that at 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. Japan 2021 there were many new contributions, one team is creating an end-user manual. Reference link https://jawordpressorg.github.io/user-manual/1_login/.

@chaion07 is focused on onboarding new members. Meeting will be set later this week for new members, details posted later on 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 #docs team is actively looking for new members and a new 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 Docs Project Lead. Block Editor End User Docs behind by 2 releases. For reference on this project see 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 at https://trello.com/b/JnTCzOsL/gutenberg-end-user-docs.

@femKreations is continuing work on the Site Health docs.

#meeting-minutes, #meeting-notes, #taking-notes, #updates

Estela Rueda 2:10 pm on June 22, 2021
Tags: docs, training   

Summary for Docs Team Meeting June 15, 2021

Attendance

@zzap, @atachibana, @mkaz, @DaisyO, @clorith, @tacitonic, @estelaris, @ashiquzzaman, @chaion07, @courane01, @kenshino

Housekeeping

Where: #docs channel on Slack
Find the complete Transcript of the meeting on Slack.

Meeting Facilitator: @milana_cap
Note Taker: @estelaris

Proposal: An audit tool for Learn

@courane01 presented the proposal for an audit tool from the #training and LearnWP team and asked the #docs team to think about what would help in revision control that could work inside a .org site?  What would help our workflows more?

It is important to have revision control features but also more granular ways of tracking entire articles, images, videos, etc. that make it a low-lift for short term contribution work.

The docs team to add requirements and ideas to the spreadsheet and to share later with #training.

A reminder

We are looking 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 Docs Project Lead. Let @milana_cap know if you are interested.

Open Floor

@webcommsat thanked everyone who participated in WCEU this year.

Jon (Kenshino) 7:13 am on March 18, 2021
Tags: docs   

Recommendations for additional team leads

Hello all

We discussed this lightly in a team meeting 1.5 weeks ago but we did not managed to put this into writing.

I have recommended that @milana_cap and @atachibana become Docs’ Team Co-Leads alongside me. They’ve been doing some great work over the last 2 years and have really stepped up in the the team’s leadership and project management aspects.

If there are no objections, we’ll solidify this decision by 28 29 March 2021 (in our Docs team meeting).

Feel free to reach out to me on #docs or via DM if you have questions!

austinsangs 1:56 pm on February 8, 2021
Tags: , docs   

Agenda for Docs Team Meeting February 08, 2021

The next meeting is scheduled with the following details:

When: Monday, February 8, 2021, 04:00 PM GMT+2

Where: #docs 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/..

Meeting Agenda

Team Goals for Q1 2021
Project Updates
New Member Mentoring
Monthly Coffee Break Summary (February 2021)
Google Season of Docs
Open Floor

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

#agenda

Ahmed Chaion 3:49 am on January 27, 2021
Tags: docs, , , ,   

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

Estela Rueda 1:47 pm on December 17, 2020
Tags: docs,   

Summary for Docs team on December 07, 2020

Attendance

@chaion07, @bph, @paaljoachim, @atachibana, @mkaz, @tacitonic, @estelaris, @tjnowell, @fahimmurshed, @kenshino, @joyously,

Thanks to @chaion07 for facilitating the meeting.

Housekeeping

Project updates

  • @atachibana reported that the contents team continued migrating and re-routing Codex to Code Reference, and in this week we processed: 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.: 224 of 355 (63.1 % from 56.1% the last week) by @stevenlinx and @Mathew McCabe
  • External Linking Policy – there was a lack of input from the team on the post but we have a deadline so for the first review of 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 Developer Handbook we have two reviewers (even though we are aiming for 3) – @themiked and myself. I’ve already done the one for “undoubtedly allowed” links. @themiked please do yours this week if you can so that we can start applying results and keep the deadline by the end of this year.
  • GSoD Documentation Style Guide – I’m working on manifest.jsonJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML. file which is needed for parsing 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/ markdown files to our very new Style Guide Handbook. Once I finish it, I’ll 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.” some good people from 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. to run it for the first time. Really looking forward to seeing this one.
  • We are asking all #docs team members to read the above post about External Linking Policy. We need your decisions and votes. As it is now, this will be a “two persons” decision.

:bee: -docs update
We have still three orphan pages on our to-do-list for 5.6

  • Updates: Image 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. page
  • new page: Image Editing features
  • Updates to Latest Posts
  • New contributor @incapit works on their first page.
  • Another new contributor will be on-boarded this week.
  • Experienced contributors are progressing in their work. @newyorkerlaura, @cguntur @bizanimesh, @collinsmbaka @geheren

New meeting time and holiday break announcement

The team chose to change the weekly meeting time to 14:00 UTC and this is the last meeting of the year 2020. We will reconvene again on 11 January 2021 at 14:00 UTC.

Monthly Coffee Break December 2020

After some discussion, we decided to skip the coffee break this month as it is too tight between the holidays and the State of the WordState of the Word This is the annual report given by Matt Mullenweg, founder of WordPress at WordCamp US. It looks at what we’ve done, what we’re doing, and the future of WordPress. https://wordpress.tv/tag/state-of-the-word/..

Google Season of Docs

Style Guide by @tacitonic

  • @milana_cap started with the manifest file for the Style Guide.
  • I’m currently writing the Formatting section.

Classification project by @dmivelli

  • I’ve reviewed the New Classification Recs tab on our worksheet.
  • I created new columns with subcategory suggestions for WP overview and Technical docs.
  • I’m still working on the Technical docs column.
  • I’ll continue this week and check in on progress by next weekend.
  • Link to the spreadsheet. We ask that peeps do not change anything, but feel free to add comments.
  • Also, the final reports by mentors and technical writer were submitted to Google last week.

There was a discussion as to what language (American English) is the basis of the style guide and there will be a focus on internationalizing the language. Also, the discussion area in GH is open, feel free to leave your comments there.

Discussion: Clarification about the use of GPLGPL GPL is an acronym for GNU Public License. It is the standard license WordPress uses for Open Source licensing https://wordpress.org/about/license/. The GPL is a ‘copyleft’ license https://www.gnu.org/licenses/copyleft.en.html. This means that derivative work can only be distributed under the same license terms. This is in distinction to permissive free software licenses, of which the BSD license and the MIT License are widely used examples. by WordPress plugins and themes

There was a discussion previous to the meeting on Slack. The conclusion is to point docs to the license page. @themiked clarified that the license question asked a few weeks back was mashed out and the license page for the plugin handbook was updated to include a link to the general WP license page and suggested the same approach is taken for the theme handbook.

#meeting-notes