Let's discuss "finding" the Downloadable Ref Manual

It seems like we have an obfuscated access to the Downloadable PDFs for the Gramps Reference Manual… particularly for the languages other than English.

It is already too hard to DISCOVER the existence of a PDF that can be downloaded for offline use. But the hotlinks for it vary (too much) in their target.

Most hotlinks are described as a “download” but go to the PDF file directly. Which downloads and displays the PDF in the the browser. The user then has to click the Download button in the browser’s GUI. (Where they have to select a target and it appears to download a 2nd time?)

Clicking through the variably identified other languages hotlinks tend to go to the top of the Language Status wiki page.

Then the user must figure out that the available downloads are linked in a column of a table in the Enabled section. (And Enabled is a bit of a “WTF is…?” stumble-step in itself. Because Enabled is pertinent to the Help button targetings in Gramps and irrelevant to the PDFs.) We could insert a new Anchor for the table so users don’t have to wade through an explanation of “Enabled”. (But it is very important to NOT add a maintenance nightmare of a second place in the wiki that must be updated whenever the PDFs are updated.)

So can we establish a standard target and label for hotlinking the downloads of the PDFs?

Background

A while back, the click-path to the online Users Reference manual was shortened and harmonized throughout the Gramps website.

That reduced the impression that we we trying to make excuses for sketchy documentation by having multiple layers of pages explaining all the resources available that augment that ‘oops’ quality. [A big ‘Thank you!’ to all involved.]

It set User frustration levels a bit higher before they even started reading about a complexity in Gramps that they did not yet understand. This predisposed new users to have an impression of excess complexity.

(We must avoid undoing that simplification improvement when improving the access to the offline copy.)

Creating an obvious anchor

A new anchor should probably be created within the Enabled section:
https://gramps-project.org/wiki/index.php/User_manual_translations#Enabled

Note that the About the User Manual pinned page in the User Manual section of this forum was an early attempt to make the various documention systems more conspicuous and inviting.

It fails in that attempt.

While more visually appealing and self-explanatory, it is buried. First, you must know that it exists. Then, you have to dig through the Help section to discover that there is a User Manual sub-category. Then figure out which of the 3 (important) pinned items to open. And (if you’ve visited the page before) scroll back to the top of the thread.

Add the complication that one is often lured away by the User Manual (links to https://gramps-project.org/wiki/index.php/User_manual) in the left menu of Discourse… even when you know better.

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.