Summary of Docs Team Meeting: 15 November 2022


Housekeeping

Attendance: @joen, @estelaris, @javier, @samanthaxmunoz, @jaedm97, @bph, @kartiks16, @atachibana, @emmaht, @webcommsat, @milana_cap, @mburridge
Where: #docs channel on Slack. Find the complete transcript of the meeting on Slack.
Agenda: https://make.wordpress.org/docs/2022/11/14/13791/
Meeting Facilitator: @estelaris,
Note Taker: @mburridge
Next Meeting Facilitator (in two weeks): TBD
Next Triage Meeting Facilitator (next week): @milana_cap

There was some initial confusion over the start time this week and some attendees didn’t join until the end of the meeting.

Project updates

 Screenshots for a few issues related to WP6.1 were done at WC Italia Contributor Day.

Update for the End Use Docs:
6.1 Closed 10 issues, more to new reviewed this week. We have about 39 To do if anyone wants to pick up.
6.0 Closed 4 issues more to be reviewed this week. We have 10 To do items

The menu block is ready for review.

@milana_cap will work on onboarding docs this week.

HelpHub Design

The design team is reviewing the design for HelpHub because the general template for WP.org has recently been changed.

Two members of the design team (@joen and @javier) were in attendance to help answer any questions that other attendees might have regarding the proposed design.

The Figma design for HelpHub was shared:

  • The change log has a new placement, at the end of the article after the feedback form. The reason for this is to make the change log a collapsible item and being the last item, once opened it won’t interfere with the flow of the article
  • @femkreations asked: “Who gets notified when the feedback form is submitted? Would it be more helpful to have a link to  GitHub where folks can create an issue if they find something wrong in the Docs?”
  • TOC’s will not be collapsible on mobile
  • The “Back to top” link will be placed under the TOC, like Vercel does with their documentation: https://vercel.com/docs/concepts/git

There was praise for the design from those in attendance.

Please note: The HelpHub Figma will be closed today so we can start preparing a final version for the developers, so today is the last chance to add your comments.

DevHub Design

The Figma design for DevHub was shared:

  • The design team needs a lot of feedback, please add your comments to the design on Figma
  • A key consideration is what content goes on the landing page
  • The handbooks will most likely get the same general updates done to the team handbook

The meta post for Improving DevHub Code References was shared.

There was also praise for the DevHub design from those in attendance.

Please note: The Figma file for DevHub will be open for the rest of this week for comment, please review the design and add your comments,

Open Floor

There was a question about Documentation Contributor badges on the .org profiles of contributors. We were assured that @milana_cap keeps track of contributions and has it in hand.

If you feel your contribution has not been acknowledged see here.

#docs, #meetings, #summary