Summary of Docs Team Meeting June 7, 2022


Housekeeping

Project Updates

WCEU contributor day

@milana_cap:

  • We had a packed WCEU contributor Day for the Docs team. We worked on various issues mostly on the block editor end user ones.
  • @bph and @leogermani helped out in co-leading and onboarding.

New block editor end-user rep

  • We have a new block editor end-user docs rep – @femkreations 
  • @milana_cap will be moving to other projects such as improving the onboarding process, updating the related docs, recording videos, and doing live onboarding sessions.

Docs design updates:

@estelaris:

  • The design for the Docs is almost done.
  • @estelaris will also add design elements for warnings and notes that @femkreations asked for. 
  • Each section of wordpress.org will have a similar look with a different color palette. This will make it easy to know what we are looking at.
  • The look and feel of Devhub will be the same as Helphub.
  • The landing page for documentation will now include everything:
    • The last section in the landing page design (under Developers) will replace https://developer.wordpress.org/
  • At some point, DevHub will also go through a site map review, as she did for HelpHub.
  • We’ll also have some kind of automated linking to the Learn platform, like a widget in the sidebar.

URL for the documentation:

@milana_cap and @estelaris:

  • There are two items on the menu under support: documentation and forums.
  • The URL for documentation is wordpress.org/support which makes no sense.
  • The URL for the documentation needs to be more obvious. e.g. docs.wordpress.org
  • Support is not a place where developers look for docs.
  • Support means interaction, docs are information.
  • Support needs to go to the support forums and not to documentation.
  • @estelaris to discuss this with Josepha and the meta team and start the implementation soon.

Moving the Action and Filter reference pages from Codex to DevHub

  • @psykro raised the question about moving the Action Reference and Filter Reference pages from the Codex to DevHub.
  • He will open new GH tickets for each one, to allow for further discussion there.
  • It will be moved into the Common API.
  • The order of firing will be updated and new hooks will be added.

Open floor

Coffee and chat

  • We are bringing back the zoom hangouts for coffee and chat.
  • It’s a 30 min hangout, once a month.
  • @estelaris will set up a doodle for the summer dates – June-August where folks can vote for the time/date.

Onboarding sessions

For anyone interested in starting to help with the docs

  • Start browsing these issues.

#meetings, #summary