Talk:Gramps 5.1 Wiki Manual
Wiki Manual, User manual, ... ?
The menu on the left shows User manual and takes you to this page Gramps 5.1 Wiki Manual. This is inconsistent and irritating. I suggest to use User Manual like the title of a book. When the Gramps version is important, I suggest to use parentheses, e.g. User Manual (Gramps 5.1). Furthermore, the top of the page could indicate where a user would find the User Manuals of previous Gramps versions.
Thanks, I'd grown familiar & oblivious to some of your observations.
The consistency on 'Wiki Manual' versus 'User Manual' is also a good point. That decision is up to our Webmaster. I'm inclined to agree that the sidebar 'User Manual' should be changed to 'Wiki Manual'
I think we're stuck with the 'Gramps 5.1' prefixes. They are part of the MediaWiki file organization system. But it is also vital for the Search Engine indexing ... so that people get to the right edition for the right software product. Also, having a fully qualified page title makes the Printable (print to PDF) page distinct from outdated copies.
The use of parentheticals is a style discussion, I think. Usually, one considers such qualifications contextually implied. (Just as you might say '1965 Ford Mustang automobile' in general conversation but only '1965 Ford Mustang' on a muscle car website, just '1965 Mustang' on a Ford corporate website and just "'65" in a Mustang group.) Our first mention is (hopefully) fully qualified but uses the shortened form elsewhere. In the menu, the Gramps is implied while the version qualification is left off to keep from having to amend instruction on the mailgroup & in other venues.
- I would like to vote for 'User Manual' over 'Wiki Manual': A 'User Manual' is a well-known term for the general computer user. We both understand what a 'Wiki Manual' is but I am afraid that users new to Gramps could be irritated by such an unfamiliar phrase. Furthermore, the word 'wiki' appears already more than once in the sidebar. 'wiki' to me is a technique rather than contents. When looking for information, I'd rather steer to a familiar 'User Manual'. Even MediaWiki has no 'Wiki ...' but it offers 'User help' and a 'Technical manual', even though all contents is 'wiki'. Hence, my thumbs are up for User Manual. --Wribln (talk) 17:16, 10 June 2020 (UTC)
- One more argument for 'User Manual': Within Gramps, F1 brings you to the 'User Manual'. --Wribln (talk) 17:21, 10 June 2020 (UTC)
+1 Renaming or calling the next "...Wiki Manual" to "...User Manual" would make it easier for people to understand they are same thing. -- Adam.
- I like this idea and agreed, but as it will involve [ ] changing the Gramps program code to point to the new name [ ] updating wiki redirect templates on artciles outside the user manual and [ ] involve a rename when I roll over the user manual if this ends up being done this will have to wait for the next major release eg: Gramps 5.2.x.
- > I think we're stuck with the 'Gramps 5.1' prefixes. They are part of the MediaWiki file organization system. But it is also vital for the Search Engine indexing ... so that people get to the right edition for the right software product. Also, having a fully qualified page title makes the Printable (print to PDF) page distinct from outdated copies.
- Not really; it's not part of the mediawiki file system or even needed for the search engine, an alternative suggestion is that it maybe possible to drop the word "Gramps" altogether because the user manual is already on the Gramps website and simply use the version number as the prefix and the word "user manual" eg: 5.2 User Manual
- eg: so pages urls would shorter and look like the following:
- etc..making it obvious (to me at the moment) that is for the 5.2 version of Gramps, what do you think?
- I'll raise a feature request to keep track of this when I get a moment.
- Thanks everyone for your contributions to making the documentation easier to get to. --Sam888 (talk) 02:18, 15 June 2020 (UTC)