Problem/Motivation

The documentation on d.org is arranged in a hierarchy of nodes, using Book module. In many cases, the nodes that are the children of a particular parent node are not in any sort of logical or clear order. Rearranging them would make the order more logical and comprehensible to readers.

Here is an example: https://drupal.org/documentation/modules/flag. The main documentation page for Flag module has a ton of child pages, which are in no particular order, and really ought to be.

However, changing the order of child pages like this requires all the weights to be set correctly in relation to one another. This requires each page to be edited. It's a slow and tedious job!

Proposed resolution

We need a single admin page with weights for all the child pages.

Book module provides an admin page with weights, at admin/content/book/%node, but:

- it's for the entire book. This would mean have access to reordering the WHOLE of the 'Structure Guide' in one go, which I don't think is a good idea. *I* wouldn't want access to that, for fear of breaking everything!!
- it requires the 'administer book outlines' permission, which is too strong.

What we need is a tab on a single book page, that allows reordering just its child pages. I feel we could grant access to that to users who can edit book pages (which is everyone).

There is a project which provides this functionality, written especially for this issue: https://drupal.org/project/book_child_order

Remaining tasks

* The docs team needs to agree this would be a good thing. DONE: #2128143: proposal: allow documentation editors to order child pages of a book page.
* the project needs to be reviewed and deployed on d.org

User interface changes

Book nodes that have child nodes will gain a new tab, where the order of the child nodes can be rearranged.

CommentFileSizeAuthor
#15 drupalorg-n2126285-15.patch2.66 KBDamienMcKenna
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

joachim’s picture

I've been advised to ask the docs team about this too: #2128143: proposal: allow documentation editors to order child pages of a book page.

joachim’s picture

joachim’s picture

Status: Active » Needs review
joachim’s picture

Issue summary: View changes
joachim’s picture

Issue summary: View changes
Mixologic’s picture

Project: Drupal.org infrastructure » Drupal.org customizations
Version: » 7.x-3.x-dev
Component: Other » Code

Moving this to the Drupal.org Customizations queue.

DamienMcKenna’s picture

Bump. This would certainly help.

joachim’s picture

Is this in the right queue?

Drupal.org customizations is the package of custom modules that provide functionality & features on d.org. But this issue is about installing a new module into the overall d.org codebase.

drumm’s picture

Each Drupal.org site has a separate codebase, this is a good queue for adding a module to www-only.

joachim’s picture

*bump*

Who should I talk to to get this looked at?

I appreciate that there's a plan to convert the docs on d.org to Organic Groups, but I don't know when that's meant to happen. In the meantime, this is a simple module to deploy on d.org which would give us an immediate benefit. It's been waiting for **two years**. That's two years of being able to rearrange the hierarchy of our docs pages and make them easier to use, that we've missed. Even if the new OG docs are just around the corner, could we have this feature now please?

DamienMcKenna’s picture

Status: Needs review » Active

I think there'd need to be a codebase update to install the module and assign the permission accordingly?

joachim’s picture

Yup. Enable module, grant its permission. That's it.

It was suggested to me on IRC that I should get people to review the module. @DamienMcKenna the only bug that has been filed on it since the original stable release in March 2014 was by you -- I assume that means you had a look at it, and that was the only problem you found?

DamienMcKenna’s picture

We haven't used it very much, but for the bit of testing I did it seemed to work fine.

joachim’s picture

*BUMP*

DamienMcKenna’s picture

Status: Active » Needs review
FileSize
2.66 KB

The module in question is: https://www.drupal.org/project/book_child_order

I'm not sure if the pieces are in the right places or if the roles are correct, but this at least gets the permission & dependency exported.