Hi everyone,

I wasn’t sure about current rule for hiding pages so I researched it and I’m 
listing below what I believe is our current status. I’d like to document it on 
dev.xwiki.org if we’re ok with this status.

Current rules:
==============

* Technical documents must be hidden
* Technical apps must be hidden and not appear in the Document Tree. These are 
apps that don’t generate content data. For example the following apps (not 
exhaustive list) have their pages hidden (including WebHome):
** Stats app
** Active Installs app
** AWM app
** Color Themes app (it generates data but not content data)
** Dashboard app
** Scheduler app
* Apps that generate content pages (ie pages that should be appear in global 
search results) must have their WebHome page not hidden (and the generated 
content pages must also not be hidden). As a consequence these apps will appear 
in the Document Tree.

Future:
=======

It would also be nice to discuss if in the future we wish to separate more Apps 
from Content and hide all Application pages (including Webhome), so that it is 
less confusing for users who would:
* Use the App bar to navigate to applications
* Use the Document Tree to navigate to content pages

I personally would like this I think but the current problem is that generated 
content pages won’t be found in global search results. Each app can provide a 
specialized search ofc but it’s not good enough. Thus we’d need to find a way 
for the entries to appear in the global search results even though they are 
hidden. One solution would be to have a way to mark a space as an application 
space and exclude those from the DocumentTree (for example).

Before we dive into the solutions in details, would you agree that it would be 
good to better separate Apps from Content?

Some Links:
===========

* Currently documented best practices about hiding technical documents: 
http://dev.xwiki.org/xwiki/bin/view/Community/ApplicationDevelopmentBestPractices
* Mail thread: 
http://xwiki.475771.n2.nabble.com/Brainstorming-Rules-for-hidden-documents-need-solution-for-Home-Page-App-for-linking-the-Dashboard-H-td7591201.html
* JIRA issue: http://jira.xwiki.org/browse/MOCCACAL-85

Thanks
-Vincent




_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs

Reply via email to