Feedback on the New Documentation

[vmassol]

@gabrielc

For example, let’s say I’m a person that has never used XWiki before, and I’m evaluating weather I should give it a try. I really care about page versioning capabilities. I somehow get to the new doc space, it looks great. I browse a bit, the pages seem short and focused. Amazing. Now, let’s see if XWiki has page versioning capabilities. I type “versioning” in the “What are you looking for?” search box… “(No entries)“.

I agree. That’s because the LD filtering is not a search.

What we discussed but haven’t implemented yet (I think we forgot a bit) is the Search. See https://design.xwiki.org/xwiki/bin/view/Proposal/Diataxisforxwikiorg#HOther which says “Proposal for Search”.

There are 2 ideas (but we should discuss them in a dedicated thread proposal):

• Use the wiki search and restrict search to the documentation space on the main wiki + a few other spaces (like content pages linked from the horizontal menu) + snippets + design wiki + etc.
• Add a dedicated search box on the doc home page (probably the best), restricted to the doc space.

@elenicojocariu let’s work on that search proposal.

BTW when I start typing “v”, “e”, “r”, “s”, “i”, etc I get the following:

@gabrielc can you explain what you did precisely? On what page you typed “versioning”?

Thx