docs icon indicating copy to clipboard operation
docs copied to clipboard

Empty index in admin_manual/enterprise/collaboration

Open jnweiger opened this issue 4 years ago • 1 comments

WHAT Needs to be Documented?

The index should mention existing sub pages. That is what an index should index to be considered an index.

WHERE Does This Need To Be Documented (Link)?

https://doc.owncloud.com/server/next/admin_manual/enterprise/collaboration/

WHY Should This Change Be Made?

The index is not useful without a way for the user to continue. User has to resort to the navigation sidebar to continue.

image


https://github.com/owncloud/docs/tree/master/modules/admin_manual/pages/enterprise/collaboration contains an index.adoc and two sub pages, collabora and msoffice. The two subpages are correctly listed in the navigation sidebar, but the index.adoc itself does not provide any way for the reader to continue reading.

Expected behaviour: (auto-generated) links to the two sub pages.

I cannot see the effects of include::{partialsdir}section_page.adoc[] -- shoud that provide the index?

jnweiger avatar Jan 07 '22 12:01 jnweiger

There is a general issue with having a drop down list. Imho it should just be a list element to be clicked having underneath the relevant documents. You are right that the current way is not optimal. Due to other prios, I have not taken a deeper look into.

mmattel avatar Jan 13 '22 08:01 mmattel