Summary for Docs Team Meeting: March 30, 2020


@chaion07, @milana_cap, @wpza, @sasiddiqui, @nao, @ibdz, @audrasjb, @nobnob, @bph, @mantismamita, @mapk, @estelaris, @sukafia, @tomf, @usmanaliqureshi, @marcio-zebedeu, @pmbaldha, @kenshino, @Felipeloureirosantos, @atachibana, @themiked

Notetaker & Facilitator selection

Notetaker: @chaion07

Notes Reviewed by: @sukafia

Facilitator for the next meeting: @sasiddiqui

Next Meeting will be held on: April 06, 2020

Project Updates

@leogermani had updated the ‘home page’ and ‘welcome message’  of the Handbook and stressed on the fact that we should define pages for the next deadline.

@milana_cap reported that In Serbia they are organizing “Translate Thursdays”, every Thursday from 6-8PM on zoom where people gather and translate whatever they want.

@bph updated, Upon request from Support Team had created a section for the 5.4 default Full screen Mode

Updating sprint 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. documentation: Adding missing blocks within the next 2 weeks.

Community Team: documentation on how to set-up a website for virtual events (Crowdcast, Live Captioning).

@Felipeloureirosantos also didn’t have updates for HelpHub translation to pt_BR. He was surprised that people actually get really excited about contributing because of the badges and so he emphasized to highlight it more.

@atachibana had 2 updates re-routing from Codex ‘Function’ to Code Reference, 431 of 1069 have been done which is 40.3% & translation of HelpHub to Japanese, 50% have been completed and they hope to keep the momentum going.

Handbook Revamp

  1. Homepage update
  • @themiked had begun his review of every 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 Plugin Directory or can be cost-based plugin from a third-party handbook page, which includes editing for clarity and accuracy, and converting monolithic “classic” blocks into actual blocks.
  • @milana_cap thought about Facilitating weekly meetings and Reporting an issue workflows with reference links: & She stressed on the urgency of these and mentioned having the Drafts available in TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the team uses for example: and Drive.
  1. Deadline for next 2 or 3 pages
  • @milana_cap suggested that we work on drafts until next Monday, then we review and discuss, fix what’s needed and publish it another 7 days later (so the actual deadline would be 14 days). Which @estelaris, @marcio-zebedu, @chaion07 and @ibdz showed support to.

Categorization Project, Alterations Workflow (discussion)

  • @sukafia shared the link of the spreadsheet for the project.
  • @estelaris addressed the 2 goals agreed upon last week:
    1. better search
    2. improve usability (in mobile)
  • @estelaris also mentioned that Roles and Capabilities is under categories Installation, Basic Administration and Getting Started
  • @milana_cap pointed out that there was no mention of User
  • @sukafia asked, if there was a 3rd goal and urged to suggest if any
  • @estelaris suggested, if we think of the menu like this: getting started > Roles and Capabilities
  • @estelaris said, and then when we go back, the system may go Roles and Capabilities > Installation. The user will go back to a different categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging. then when he/she started. that is not good. then we have the title
  • @Kenshino gave 2 examples of User stories:
    1. “As a first time user, I should be able to figure out whether WordPress is adequate for my needs easily”
    2. “As a user, I should be able to figure out which articles to look at without knowing WordPress terminologies”
  • @mapk added to the point made by @estelaris that revisiting some of those titles could help with the latter
  • @tomf said that it’s good to define a number of steps also in terms of ultimately finding information from a start point and use that as a scaffolding target. It’d be good to have a user stories doc as we really will probably keep having more of these that fit into a theme to identify areas of improvement
  • @sukafia outlined the goals:
    1. Better discoverability
    2. Improve usability
  • @estelaris said that she will add the stories to the working document and write a few for next week we can move from there
  • @kenshinoo Called  on volunteers to help write user stories and suggested that if everyone could target writing 3 based on our understanding of how people want to access user docs, we’d have a lot!
  • Due to time running out for the meeting we had to move to the next topic.

Open Floor

  1. @adamsilverstein expressed his thanks to the ‘Docs Team’ for everything we do. He introduced the team to the recently announced “Season of Docs”, a Google’s effort to help 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. projects with documentation and pointed out that it may be a good opportunity to get some additional resources towards tackling documentation goals or projects. :
  2. @nobnob asked on the changes to HelpHub articles, for example the one indicated by @bph were automatically updated on Rosetta sites or, conversely, how we translators can be informed.
  3. @milana_cap answered, unfortunately, rosetta sites are not notified
  4. @Bph replied to @nobnob that there aren’t any notifications. The best would be to have an RSS feedRSS Feed RSS is an acronym for Real Simple Syndication which is a type of web feed which allows users to access updates to online content in a standardized, computer-readable format. This is the feed. for articles enabled and send out notifications. @bph also asked @nobnob would a post in the #polyglots channel help? She would make a note of that, to include it when there are updates on support/articles.

Transcript of the meeting can be found here on slack

Thank you all & please stay safe!