Skip to content

Remove outdated translated developerGuide, or move to Crowdin (was: remove outdated files) #13333

@CyrilleB79

Description

@CyrilleB79

Issue opened after discussion in #13119 (comment) and #13119 (comment) regarding translated developer's guides.

Steps to reproduce:

List the file names in all the language subfolders of user_docs folder.

Actual behavior:

The most common (and expected files are: changes.html/.t2t, keyCommands.html/.t2t, styles.css, userGuide.html/.t2t.

Still remaining - to be either removed or moved to crowdin:
developerGuide.html/.md in de and pt_BR folders
Last commits: Fri Aug 3 2012 (de) and Tue Aug 9 2011 (pt_BR)

Removed:

  1. locale.t2tconf files are present for ar, fa and he languages to manage right to left text direction and arabic numbers.
  2. locale.t2tconf in ca (Catalan) folder
    Last commit: Wed Aug 20 21:42:40 2014 +0100
  3. hu\chapter0.t2tinc
    Last commit: Wed Mar 20 2013
  4. th\key commands.txt
    Last commit: Sun Dec 14 2008

Expected behavior:

The files listed in 1. and 2. are expected. The files listed in the other points were not expected. The question arises of removing them for the following reasons:

  • Files listed in 4. and 6. are very old and it is expected that such files are updated regularly (dev guide and key commands). It should be investigated if these files are still of any use for their respective community (de, pt_BR and th) since they are probably far from up-to-date.
    Note that "th/key commands.txt" is not even opened when setting NVDA in Thai and clicking the "Key commands" item in the "Help" menu; English key commands html file is opened instead. Either this file should be renamed "keyCommands.txt" to be accessed through the menu or some dead code could probably be removed from getDocFilePath in file documentationUtils.py.
  • ca\locale.t2tconf (3.): I wonder why Catalan needs a specific processing with respect to other latin languages. Either other languages should benefit from what has been done for Catalan, or this specific processing for Catalan is not needed anymore; to be investigated.
  • Point 3.: hu user guide adds additional specific content. It should be stated if local teams are still allowed to include such specific content with respect to the standard user guidd. This decision can be made when the new translation framework is set up.

System configuration

NVDA installed/portable/running from source:

N/A

NVDA version:

2021.3.1

Windows version:

N/A

Name and version of other software in use when reproducing the issue:

N/A

Other information about your system:

N/A

Other questions

Does the issue still occur after restarting your computer?

N/A

Have you tried any other versions of NVDA? If so, please report their behaviors.

N/A

If NVDA add-ons are disabled, is your problem still occurring?

N/A

Does the issue still occur after you run the COM Registration Fixing Tool in NVDA's tools menu?

N/A

Cc @bdorer, @mhameed who have committed on these files.
Also wanted to cc David Parduhn, Rene Linke and Peter Vagne, but I do not have their GitHub user name (if they have one).

Metadata

Metadata

Assignees

No one assigned

    Labels

    blocked/needs-product-decisionA product decision needs to be made. Decisions about NVDA UX or supported use-cases.component/user-documentationneeds-triagep4https://github.com/nvaccess/nvda/blob/master/projectDocs/issues/triage.md#priority

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions