Summary of Docs Team Meeting Sep 21, 2021

Housekeeping

Project updates

@tacitonic:  The WordPress Documentation Style Guide has been completed. This includes all the remaining articles, the word list, and the usage dictionary.

15 min repo triage:

Issue 1(labeled needs-discussion): Some end-user docs are too technical

@milana_cap: Agrees we shouldn’t have technical details in the end-user docs. But raises the question – where, in DevHub, should that info live?

End-user docs are for people who don’t code and most likely don’t deal with hosting/server issues but rather contact support. We need a place in DevHub that will be dedicated to tasks like .htaccess, internationalization, localization, etc that are shared throughout developing with WordPress. These are neither 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/theme topics nor common APIs but also are not the end-user concerns. 

She suggests we collect all the articles in the support section that are technical. This will help to get a better picture of the dedicated space we will need to create in DevHub.

@basilh  – Suggests hyperlinks to a dedicated space on wordpress.org for topics related to ApacheApache Apache is the most widely used web server software. Developed and maintained by Apache Software Foundation. Apache is an Open Source software available for free. and NginxNGINX NGINX is open source software for web serving, reverse proxying, caching, load balancing, media streaming, and more. It started out as a web server designed for maximum performance and stability. In addition to its HTTP server capabilities, NGINX can also function as a proxy server for email (IMAP, POP3, and SMTP) and a reverse proxy and load balancer for HTTP, TCP, and UDP servers. https://www.nginx.com/., etc. 

@milana_cap: Agrees to move all such info to another location on wordpress.org. And maybe say something like “For more advanced server settings take a check out this link”

ACTION ITEM: Please add your thoughts in the comments for the issue in GitHub.

Issue 2 (labeled good-first-issue): Update links inside the posts-screen DOC

  • @muhammadfaizanhaidar is unable to recreate the issue and will update in the comments for that issue. 
  • @TC to take a look at the issue, if needed.

#summary