User manual translations page that is outdated about status

The translations of the wiki’s status page (User manual translations) are varying degrees of outdated. Only the pages of 3 languages are current.

Most are so different that starting fresh with the 6.0 English page would be closer than trying to update the old revision. Should the versions prior to 5.1 simply be deleted?

Languages (Portal 5 years out-of-date v5.1.2):

6.0 • English
6.0 • Deutsch
6.0 • עברית
5.1 • русский
5.1 • slovenščina
5.1 • Türkçe
4.2+ • français
4.1 • Nederlands
4.0 • italiano
3.4+ • polski
3.4 • español
3.2 • català
3.1 • suomi
3.0 • svenska

[Admin: Related Gramps 6.0 Wiki manual Stub eradication ]

Why try to maintain such a range of languages when browsers can automatically translate a page that’s not in the local language?

3 Likes

Especially because it clogs up the search so much.

No, that is up to the translator, when the translation is updated by them.

This portal table was for the program translation itself and manually updated to show coverage as detailed on the templates page , but now that we use Weblate, it is automatically updated on that website. I’ve removed those coverage columns on the wiki.

2 Likes

That looks much better. Thanks!

The Weblate graph SVG is showing as a URL instead of a graphic on the Portal page.

1 Like

I’m aware and the issue this time is on Weblates end, waiting on them to fix/whitelist the Gramps domain. Fortunately visiting the URL directly does work.

https://hosted.weblate.org/widget/gramps-project/horizontal-auto.svg

1 Like

Looking at the history for some of the most out-of-date, the only edits have been by non-translators for many years.

They are, in essence, abandoned. So they will are unlikely to be updated by the translator and that decision falls back on us.

That may be, but deletion is not the answer, I suggest simply adding a message that page is outdated and to use the English user manual kind of like how @Gioto & @Patsyblefebre are going with the following template?

That looks interesting!

I just discovered today that the French translation of the wiki is entirely missing an important chunk.

A geneanet posting exhibited a complete misunderstanding about adding to the Projects list of curated collections. (They were trying to manually download SuperTool addon via the raw.githubuser URL.)

I was going to explain by linking to the French translation of the Gramps 6.0 Wiki Manual - Navigation#Using the Addon Manager. But their translated wiki page does not even mention the Addon Manager.

I wonder if other translations are missing this critical section?

From a quick check, it looks like “most of them” are missing the Addon Manager

Chapter 10: Navigation is the wrong place for this content anyway. The only reason it is in “Navigation” is because it is a Toolbar icon.

What do people think of moving it to Chapter 11: Plugin Manager and renaming the chapter to “Plugin Management”? (But leaving the original anchor intact for backward compatibility.) And that Toolbar mention can be reduced to a simple Glossary-like entry with a link to the full introduction in Chapter 11

It would be a good place to explain why there is a separate Plugin Manager and how it differs fro Addon Manager.

I agree with that but the issue is a lot of terms (in grey) aren’t translated (here in French):


It seems that the formatting of the wiki text is preventing translation.

Additionally, probably some terms associated with tools and actions in Gramps, which are translated by humans (Weblate) and not automatically, may differ between the English documentation based on what is stated in Gramps and that in Weblate.

After reviewing the Chapter 10 section, I am even more convinced that the introduction to Addon Manager is the misplaced content for the chapter. That chapter is more about strategies for getting more out of a feature.

The introduction would transplant easily into Chapter 11 and would help users realize that it is different from the Plugin Manager

But what Addon Manager strategies could replace it? How can users get more out of the tool?

We need to do something about this, but I’m not sure what. Translations make the search almost unusable. Are translations not in their own namespaces so that we can restrict search results? I assumed they were since the names match the Namespace:PageName format, but when I restrict to the main namespace in a search, it still returns translations. Can we re-org the Wiki somehow?

I recommend downloading the wiki PDF and searching within it.

As you say, the wiki search is almost unusable.

And that is what I’ve done personally, but I do think that a functioning wiki is vital to the adoption of this software by more people. I’m not sure if that needs to be a whole other conversation or what. But just knowing that search is useless means we have a lot of work to do.

Does anyone have some spare time to investigate this?

I’m open to re-structuring the wiki if it will make it more usable and easier to maintain in the future.

That objection is a bit overly dramatic. The wiki is functioning. The search may not be useful but information content has become vastly more complete in the last few years. And the “wiki” portion continues to work… it lets contributors continue to colloratively enhance the site.

And the downloadable Manual was recently restored. (After being broken for many years. Thanks again @GaryGriffin !) The Gramps Glossary has recently evolved into a viable curated index. And the GUI-based Help buttons were just hugely enhanced to make plug-in help more useful.

But index is a symptom of a more systemic issue. That the MediaWiki CMS is not sucessfully allowing updates, nor plug-in installations.

The basic search does not have such an option. Not even in the Advanced options.

Upgrading the search would help (but not resolve) the language complexity.

The quickest way to find information in Wikimedia projects is to look it up directly. On every page there is a search box.

CirrusSearch is a MediaWiki extension that uses Elasticsearch to provide enhanced search features over the default MediaWiki search. The Wikimedia Foundation uses CirrusSearch for all Wikimedia projects.

The internal indexer also seems to ignore mediwiki tags that suppress indexing of certain (like obsolete) pages.

And translated pages tend to be “fresher” than the English base pages. (Because updates to the English pages are triggers that remind translators to update.)

I started to translate the user manual few days ago, and I ask myself for whom are you translating the manual? The answer is for those genealogists who do not have an IT or programmer background and those that are not fluent in English.
And this leads to a dilemma - the user manual is very technical and covers all aspects of Gramps. That is a lot of stuff a plain user does not care about, so why should I spend time translating all this?
My suggestion is that we divide the user manual in two - a User Guide and a Reference Manual.
The User Guide should be translated, but the Reference Manual only in English. This will solve two problems. There will be less text to translate, and search in the Reference Manual will avoid all the different language pages, which most regard useless.

3 Likes