[buddypress-trac] [BuddyPress Trac] #8897: Include user & developer documentation into the BuddyPress repository

[buddypress-trac]

#8897: Include user & developer documentation into the BuddyPress repository
----------------------------------+----------------------------------
 Reporter:  imath                 |      Owner:  johnjamesjacoby
     Type:  task                  |     Status:  new
 Priority:  high                  |  Milestone:  BuddyPress.org Sites
Component:  BuddyPress.org Sites  |    Version:
 Severity:  major                 |   Keywords:
----------------------------------+----------------------------------
 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 https://meta.trac.wordpress.org/changeset/12056 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.

-- 
Ticket URL: <https://buddypress.trac.wordpress.org/ticket/8897>
BuddyPress Trac <http://buddypress.org/>
BuddyPress Trac