To Note: async (asynchronous) is a situation when an individual is not present during the meeting but, made an effort to make their presence known after the adjournment of the meeting. Additionally, user handles are taken from their respective Slack accounts and may not match up to WordPress.com accounts.
Highlight: We were graced by the attendance of 2 new attendees (1st time for the docs-chat meeting), @mjaragon and @chellycat which was a pleasant surprise. @mjaragon had questions regarding contributing to the documentation effort which was, more or less, confirmation of a basic understanding of how the documentation process worked, in general.
The stats – 58%, there was no change in percentage points – 58% ➡ 58%
NOTE: The stats remained flat due to no new issues were submitted and completions remained the same..
There is 1 (one) issue that is currently In Progress. For details see the In Progress section (Note: Project views are dynamic and are subject to change without notice).
Due to a reduction in the number of writers/authors, the documentation effort has slowed to a crawl.
The anomaly (truncated entries) with exporting view data while in Board layout was still present.
There is a correction to this agenda item, what was published during the meeting was a heading containing the text – Part 3, when it should have been Part 4.
Regarding the feasibility studies, the approach that was settled on was to tackle one study at a time with the first up being the Slate Docs tool:
Notably, @dcavins brought up the fact that there is, currently, an established format for the BP REST API Handbook (version 1) that is Web based. The pages for this Handbook were manually created via the backend (wp-admin > BP REST API Handbook pages) on the developer.buddypress.org site. Although not mentioned during the meeting, there is also the beginnings of a new subchapter/section for the version 2 BuddyPress REST API (v2) source documents located in the main BuddyPress repository.
The following is a list of potential tools that will/may have an impact on the document creation process, on deck for a feasibility study is the 1st item, the Slate Docs tool (API Docs Generator), as previously indicated.
- Conduct feasibility studies for 4 possible hosting tools and choose the best or most practical option, which should determine the “final web home“, coined by @dcavins :
❗ – in progress, ⭐ completed – toying with emojis to indicate basic status of any given study – no emoji indicates “to do”.
To provide context to this ongoing saga, there was information posted related to the backstory of how the documentation effort has progressed from inception to the current process for the creation of documentation, for example:
BP Documentation choices
- July 12, 2023: use BuddyPress code repository to reorganize/migrate/update/improve the BuddyPress Codex.
- January 10, 2024: create this repository to track BuddyPress Codex migration tasks as well as new documentation tasks.
- January 24, 2024: using GitHub to contribute on the next BuddyPress documentation is our choice & it’s a good one!
Note: This agenda item is slated to be on the agenda for the next documentation meeting as a continuance.
Open Floor:
The following are the specifics to the questions that @mjaragon had raised (as indicated in Highlights):
“In order to contribute to the BuddyPress doc project (as a non-developer), the steps would be:
- Pick one of the tasks from the “todo” column in the board (like for example, “[Add]: Members component explanation“)
- Use the outdated codex page as a baseline to create/update the new documentation (example for the members component)
- Create the new/updated doc as a .md file (similar to this one)
- Commit & submit a PR to merge that new page I create to the docs repo (in the case of the members component, it’d be to
buddypress/docs/user)”
Additionally, @mjaragon declared the following:
“I have something to declare!
I was very, very happy to find that this docs-update project is currently active.
BuddyPress is an amazing tool, and it broke my heart a little every time I encountered out-of-date documents or corners that hadn’t been maintained for a while.
It is very motivating and energizing to know that you’re all continuing to work towards an updated version that could help share BuddyPress with more people who might not yet know about it (and might be discouraged from using it due to what I mentioned above).
It’s a great plugin, it’s served us well, and it deserves the love”
Lastly, there was a brief conversation regarding the possibility of renaming some of titles for the Support forums, e.g., from How-to & Troubleshooting to just Troubleshooting. The rationale is that there appears to be some redundancy/overlap with forum titles and in the previous example, the How-to can be covered by the Creating & Extending forum. Since this was just some initial thoughts, more would have to be detailed out to make sense of this thought (tip of the iceberg), perhaps in a discussions topic within the bp-documentation repository.
Next Docs-Chat
Our next documentation meeting will happen on April 30, 2025, at 19:00 UTC in #BuddyPress.
#docs-chat, #documentation, #summary