Skip to:

#8897 closed task (fixed)

Include user & developer documentation into the BuddyPress repository

Reported by: imath's profile imath Owned by: johnjamesjacoby's profile johnjamesjacoby
Milestone: Sites Priority: high
Severity: major Version:
Component: Sites Keywords: has-patch


Now we’ve migrated to the BP Rewrites Parser, we need to achieve an important documentation work.

We also need to renovate our documentation plugins and themes, if you look at You’ll see the wporg-developer theme is no more included into Meta Trac and is moving to a Block theme . As our bporg-developer theme is a child of the wporg one, we’ll face an issue sooner or later as to my knowledge it’s not possible to build a block child theme.

I think we should care about documentation as we care about code and reward it as we do for code, using props so that contributors can get a beautiful BuddyPress badge on their WordPress profile. That’s why I believe we should include a new docs directory inside the BuddyPress repository and enjoy the Markdown importer the handbook plugin is making available. We could use GH PRs to manage documentation updates and synchronize the BuddyPress documentation sites (developer and a new user one) with our GH repository.

Having our documentation into the BuddyPress repository would also allow us to wait for the plugins/theme renovation work to be achieved.

Change History (3)

This ticket was mentioned in PR #102 on buddypress/buddypress by @imath.

11 months ago

  • Keywords has-patch added

I've tested a quick implementation building this plugin. Below is a screenshot of the result on my local development environment (VVV + Meta).

As you can see the content of this PR's /docs/developer/ has been added to my local BuddyPress developer documentation site.

Trac ticket:

This ticket was mentioned in Slack in #buddypress by imath. View the logs.

11 months ago

#3 @imath
11 months ago

  • Resolution set to fixed
  • Status changed from new to closed

In 13501:

Add a /docs directory to provide User and Developer documentation

Just like the WordPress REST API or Gutenberg did, we are now using our GitHub repository /docs directory to contribute to User and Developer documentation.

This commit inaugurate this new space with some documentation pages and assets.

Fixes #8897

Note: See TracTickets for help on using tickets.