Summary for Docs Team Meeting: 11 May 2020

Attendance

@makewebbetter @atachibana @mkaz @marcio-zebedeu @annezazu @milana_cap @chaion07 @bph @ibdz @collinsmbaka @kartiks16 @nobnob @mukesh27 @felipeloureirosantos  @wizzard_ @fahimmurshed  @ataurr @netpassprodsr @estelaris @crstauf @timohaver @immeet94 @softservenet @kulsumsiddique @thisisyeasin @sukafia @sasiddiqui @leogermani @themiked @kenshino @rabbirshad199621

Agenda

You can find the Agenda here.

Notetaker: @makewebbetter & @thisisyeasin

Notes Reviewed by: @chaion07

Facilitator: @chaion07

Facilitator for Next Meeting: @estelaris

Follow the meeting on the Slack channel for Docs

Project Updates

@leogermani provided updates async to the meeting:

  • Common APIs – migrate 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. from plugins Handbook
  • Migrate 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.
  • Organize workflows within the Handbook

@atachibana reported that for re-routing of the Codex page to Code Reference for functions, 908 out of 1064 (84.9%) have been completed. He thanked @collinsmbaka and @stevenlinx for the jump from 67.4% recorded last week.

@themiked reported 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. to single blocks continues in the 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 and he identified a few things that don’t belong to the handbook. He also identified terminology disparities that he is tracking and trying to unify for example “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.-data” vs “metadata”.

@bph added a few more categories under “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” to the articles. Both @bph and @estelaris are collaborating with each other to complete the review process. However @estelaris believes there might not be further update for reclassification until WCEU 2020 which happens in 3 weeks.

WCEU Online Contributors Day

@milana_cap emphasized on “Getting started at a Contributor Day page to be completed by this week and asked for suggestions from new contributors as well as others. She further added by referring to the Polyglots Team where they had used cool tools in their templates such as Translation Statistics tool, Translation Consistency tool etc. @leogermani & @wizzard_ volunteered to help. (Ref)

@milana_cap also proposed for scheduling a meeting between 25 May & 3 June using 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/. for new contributors. She further added by saying that this meeting could be a great opportunity for @sukafia’s mentorship program. @estelaris pointed out that the first meeting should also be for the on-boarding of the new contributors and it is important that everyone has their own Slack account and access to Making WordPress work space. Following the first meeting there should be a second meeting on the WCEU 2020 contributors day after the opening remarks but using video. @estelaris also reminded us that the deadline for video submission for the individual “Making WordPress” teams is Thursday and it would be better if a Team RepTeam Rep A Team Rep is a person who represents the Make WordPress team to the rest of the project, make sure issues are raised and addressed as needed, and coordinates cross-team efforts. created the video. Update async to the meeting: @milana_cap had already prepared a video and shared with the team for feedback.

Update async to the meeting: @leogermani edited the page and made a comment on p2: https://make.wordpress.org/docs/2020/05/09/docs-team-preparation-for-wceu-2020-contributor-day/

@milana_cap thought that it would be good to include all the tools we are using which can be found in Workflow -> Reporting an Issue page.

Creating a task list for WCEU 2020

@milana_cap emphasized on creating task lists for both beginners and advance contributors and requested everyone to define what they want to do during the day for the project. Additionally, she will create a new 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 which would include instructions with links. Here is the action plan:

Monthly Coffee Breaks/Zoom sessions

@chaion07 reported that the docs team had their first Virtual Coffee Break with several people attending. The participants spoke about how they are coping with the quarantine and isolation and what we are doing to keep ourselves busy, @sukafia had facilitated the last Coffee Break. The coffee break would take place monthly over Zoom. @sukafia will create another doodle for everyone to participate for the scheduling and accordingly be notified through the Slack channel.

New members Mentor training

@sukafia has reached out to new members and reported that some of them would start contributing within the week. He also recommended @lvg2013 that she wants to contribute to the block editor for docs. The plan for new contributors is that they’ll contribute using Google docs and once reviewed, they’ll be given guidance for their contribution to prosper ahead.

Open Floor

@milana_cap proposed that we should officially decide on  External Linking in Docs Policy but @kenshino suggested that he will make a decision by next week after reviewing all the comments. @themiked also posed the following points async to the meeting on external linking with the following questions.

  • Who has the authority to add a link to a page?
  • Who has the authority to remove a link?
  • If I (me personally) write an article on my own site and then link to it, is that seen as a conflict?
  • Will we police the links to ensure they are still valid?
  • Will we police the links to ensure the content has not changed, such as by the result of a domain transfer?

@makewebbetter inquired why are we not writing excerptExcerpt An excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. in all articles listed inside categories such as advanced-topics and when we called excerpt in the code template of this archive page we used to call excerpt but as the excerpt field left blank so first para content will automatically be fetched.

Transcript

https://wordpress.slack.com/archives/C02RP4WU5/p1589209219221400

Please feel free to suggest any changes to the meeting notes by mentioning in comments !

@makewebbetter

#summary