[buddypress-trac] [BuddyPress Trac] #8658: Improve the BP Codex chapters organization

[buddypress-trac]

#8658: Improve the BP Codex chapters organization
-------------------------+-----------------------------------
 Reporter:  imath        |       Owner:  (none)
     Type:  enhancement  |      Status:  new
 Priority:  normal       |   Milestone:  BuddyPress.org Sites
Component:  (not sure)   |     Version:
 Severity:  normal       |  Resolution:
 Keywords:  needs-codex  |
-------------------------+-----------------------------------
Description changed by imath:

Old description:

> I've been analyzing the way the codex is organized today. I've updated BP
> Codex Table of Contents and realized we have a bunch of issues :
>
> - Some parent pages where children are not displayed are useless until
> they got their children back 😁 (see [https://codex.buddypress.org
> /getting-started/guides/ here], [https://codex.buddypress.org/getting-
> started/guides/deprecated-guides/ here] and [https://codex.buddypress.org
> /getting-started/guides/ there]...)
> - Some important documentation does not have a parent page which make it
> difficult to maintain, eg: https://codex.buddypress.org/emails/
> - Why keeping https://codex.buddypress.org/legacy/ and child pages if
> users can't reach it from the codex navigation ?
> - well there's some work :)
>
> You'll find the updated TOC attached to this ticket, we'll be able to use
> it to carry on updating/improving the codex.
>
> NB: We shouldn't use our own tools to host BuddyPress related material, I
> couldn't do anything with the current
> [https://docs.google.com/spreadsheets/d/1BbIX4KfcWrIiUhfWhKJymdBZk4xc6ALm6Pux0MWk7x4/edit#gid=0
> table of contents] and had to restart from scratch.

New description:

 I've been analyzing the way the codex is organized today. I've updated BP
 Codex Table of Contents and realized we have a bunch of issues :

 - Some parent pages where children are not displayed are useless until
 they got their children back 😁 (see [https://codex.buddypress.org
 /getting-started/guides/ here], [https://codex.buddypress.org/getting-
 started/guides/deprecated-guides/ here] and [https://codex.buddypress.org
 /getting-started/guides/ there]...)
 - Some important documentation does not have a parent page which make it
 difficult to maintain, eg: https://codex.buddypress.org/emails/
 - Why keeping https://codex.buddypress.org/legacy/ and child pages if
 users can't reach it from the codex navigation ?
 - well there's some work :)

 You'll find the [https://buddypress.trac.wordpress.org/raw-
 attachment/ticket/8658/buddypress-codex.pdf updated TOC] attached to this
 ticket, we'll be able to use it to carry on updating/improving the codex.

 NB: We shouldn't use our own tools to host BuddyPress related material, I
 couldn't do anything with the current
 [https://docs.google.com/spreadsheets/d/1BbIX4KfcWrIiUhfWhKJymdBZk4xc6ALm6Pux0MWk7x4/edit#gid=0
 table of contents] and had to restart from scratch.

--

-- 
Ticket URL: <https://buddypress.trac.wordpress.org/ticket/8658#comment:1>
BuddyPress Trac <http://buddypress.org/>
BuddyPress Trac