Being a long time Gramps user but never having considered contributing to the Gramps Wiki, perhaps I can share my view in this context. I think the Gramps Wiki is very impressive, with lots of detailed documentation and even translated into many languages. I appreciate the time and effort so many in the community have invested in it. Still, I’ve never really gotten to grips with it, and I suspect there are other users who feel similar.
In my opinion, the Gramps Wiki tries to be too much at the same time, and this makes id unwieldy.
It is, at least:
- A multilingual user manual for the current version
- A history of user manuals for all previous versions
- A developer documentation site
- A repository of enhancement proposals (many of which outdated)
- A collection of tutorials
- A collection of general genalogy hints
Again, this is not to dismiss anybody’s efforts and I am aware there are many nice “overview” and “portal” pages that can help navigating this forest, but very often when I google something or use the search function in the Wiki, I am unsure in which part of the above bullet list I’ve landed.
For me, the download page is a good example of this, if you compare it to this, for instance. It’s a mixture between download page, tutorial, change log, …
I once read a review of Gramps in the journal of the German Association for Computer Genealogy and as one of the weak points it mentioned that it’s “hard to install”. Which we know isn’t true at all, but I think many users are scared by the - in parts too detailed - documentation.
What I would find more user friendly would be to have, clearly separated:
- A multilingual documentation site for the current version. (The archive of previous versions can still be made accessible, but more hidden then they are at present.) This is basically the “Gramps Wiki Manual” section of the current Wiki. But I’d like to be able to search it without results from the other tutorial/developer/… sections showing up.
- A developer documentation site. Only for developers/contributors. No need to be multilingual.
- Everything else (tutorials, general advice, …) belongs either to Discourse or to a separate Wiki (not mixed with the documentation).
There are fantastic open source tools like Docusaurus that might make for a more accessible/clean/user friendly alternative to documentation than a Wiki (see the Home Assistant Dev Docs as an example I like).
Again, please don’t take this as criticism of people’s efforts on documenting Gramps, which are all in all very impressive.
Sorry if I hijacked this thread!