XWiki.org Documentation Reorganization (batch 3)

[vmassol]

@gabrielc

Having a navigation tree visible on each page. I’m imagining it being on the left side panel.

This is true in both options of proposal 7.

@gabrielc

Having previous / next links at the bottom of each page

I’ve replied above to Michael. I don’t see how this would work as there’s no order. What order do you put in a FAQ item list?

If you’re talking about having a reading list (ie some tracks depending on large topics that you want to achieve like “Getting Started” - for users -, “Write your first Application” - for developers -, “Advanced XWiki features”, etc), I’ve also tried to answer that in my answer to Michael’s post above. For these, I agree that there can be a previous/next order.

@gabrielc

Having child pages displayed somewhere, ideally at the bottom of the page, as to not clutter the main content.

Cool since that’s part of the proposal already… See Proposal 6 above

Thx!

[vmassol]

@elenicojocariu

• Add a “Landing page” type to the Doc XClass (see proposal 4). The rationale is that we could have used a “Reference” type for these pages but we don’t want to display them when the reader is looking for reference pages as we don’t think the reader will expect to find them listed.

We’re retracting this part since we don’t think it’s needed:

• The landing pages are not doc pages
• We can’t reuse the Doc XClass anyway since some landing pages are for several doc types (like the main landing page)
• The option 2 of proposal 7 is already showing all landing pages so there’s no need to categorize them to provide a list somewhere. If that need ever appears, we’ll just add a new XClass.

Thanks