user tip How to change order of Chapters in Documentation? (and related questions)

The Documentation module does not seem to provide any Settings control to let Admin change the order of:

1. Chapters, or
2. Contents in the higher level Table of Contents (not to be confused with the Table of Contents shown inside individual documents created in Documentation).

Am I missing a settings control that does exist, or is there no way to control the organisation of Documentation after it has been created?

3. Also, what is the intended difference in function of the "Chapters" function and the upper level "Table of Contents" function?

Should we be using one or the other, not both?

I understand that the lower-level Table of Contents function inside a document is a useful way to help guide users through a long document, without needing to scroll through irrelevant areas of the text.

4. Perhaps different terms are needed to refer to "inter-document contents" and the "intra-document contents".


--
PJ Matthews, Kyoto
Migrated from Ning 2.0. Now at Jamroom 6 beta and using Jamroom Hosting for The Research Cooperative (researchcooperative.org)
updated by @researchcooperative: 04/29/18 01:55:36PM

It's very simple - you click on them, drag them to where you want, then drop them.

Chapters are the caategories you put the docs into.

Try making 3 or 4 empty pages and play around with it for a few seconds. I'm sure you will understand it all then.


--
¯\_(ツ)_/¯ Education, learning resources, TEL, AR/VR/MR, CC licensed content, panoramas, interactive narrative, sectional modules (like jrDocs), lunch at Uni of Bristol. Get in touch if you share my current interests or can suggest better :)

Great - that helped a lot.

Here is my new interpretation (perhaps it can be adapted for use in JR documentation?)

1. To change the order of chapters, drag and drop in the chapter list view. The chapter numbering will change automatically.

2. To move documents between chapters, open the document in the editing view, then change the category (i.e. chapter title) to an existing category in the dropdown menu, or create a new category.

If a category is left completely empty, it will conveniently disappear from the Chapter list.

3. To change the order of documents within a chapter, view document list in the "Table of Contents" view, then drag and drop.

4. To change the order of sections within a document, drag and drop does not work (why not?). However, the order can be changed by (i) copying the contents of one section to a clipboard, then (ii) creating a new section with the (rather obscure) "Add new section" button, then (iii) pasting the old section contents into the new section editor and saving. (iv) After the copy is saved, the old section that is now redundant can be deleted with the section editing tools.

I would be nice to have the drag and drop option for sections in documents!

Thanks.


--
PJ Matthews, Kyoto
Migrated from Ning 2.0. Now at Jamroom 6 beta and using Jamroom Hosting for The Research Cooperative (researchcooperative.org)

You can drag and drop document sections as well.


--
¯\_(ツ)_/¯ Education, learning resources, TEL, AR/VR/MR, CC licensed content, panoramas, interactive narrative, sectional modules (like jrDocs), lunch at Uni of Bristol. Get in touch if you share my current interests or can suggest better :)

Hmm... thanks.

There is a kind of cross-hair thingy that appears when my cursor is hovering over the document section text when not in editing mode. So I clicked and yes, it is sticky and allows me to start dragging the whole text. But then I run out reach because my laptop screen is too small. I can't actually drag the later section into position above the earlier section, and vice versa.

Nor can I drag and drop the section titles in the section table of contents, at the top of the document. That is what I expected after being able to drag and drop the document titles and chapter titles.

So, yes, in principle the document sections can be dragged and dropped, but it does not seem intuitive or convenient. I should be able to do it at work, on my larger work screen.


--
PJ Matthews, Kyoto
Migrated from Ning 2.0. Now at Jamroom 6 beta and using Jamroom Hosting for The Research Cooperative (researchcooperative.org)