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