Translation Style Guide (all SecureDrop languages)

2 posts were split to a new topic: Which pad hosting platform should we use?

Hello everyone! Sorry for the delay in sharing notes and updates (pardon, but still in the contested Sandstorm pad for the time being) from our discussion last Thursday.


A concise summary of the 04/19 meeting:

We primarily looked over the Mozilla Style Guides (also published with GitBook) and discussed how these existing language team style guides could be utilized and adapted to support Localization Lab supported projects as well as further development for the Mozilla teams.

Language Team Style Guides:
One proposal is to fork the Mozilla style guide and contribute to it instead of reinventing the wheel. If / when is not relevant to both the LocLab and / or Mozilla teams or consensus cannot be reached between both organizationsā€™ contributors, developments can be made to the LocLab fork.

General Project Style Guides:
We briefly discussed how to deal with project specific guides. @dachary recommended that there be a general LocLab style guide that individual projects then fork and develop as opposed to LocLab maintaining project-specific content in the guide. Maintaining all projects in one repository will likely be messy as projects come and go. For projects that do not have the technical skills or resources to fork and maintain their own guide, it can be done by LocLab.


@dachary met with me today to propose a trial-and-error approach for developing style guides from last week.

The approach starts small, focusing on one language team to test the process, document it, and then determine if it makes sense to scale or not.

Style Guide Trial Proposal:

  1. Create a Localization Lab framagit account and Style Guide project.
    *Why framagit? Because it is free software, maintained by a non-profit, offers hosting and self-hosting options.
  2. Import Mozilla Style Guide
  3. Propose a modification to the style guide to illustrate how it is done.
  4. Make a sample publication of the style guide with modification.
  5. Select a guinea pig language team.
  6. Language team discusses a change they would like to make to the Mozilla language team style guide. (Preferably one that is likely to be accepted by Mozilla.)
  7. Propose change to Mozilla style guide.
  8. Discuss change with Mozilla team (which will then either be accepted or rejected.)
  9. Make any rejected changes to LocLab fork.

After following through with the above process and documenting, we can revisit whether or not this is a reasonable approach (and hash out publication details, soliciting language team contributions etc.) or if we want to go in a different direction.

Thoughts?

1 Like

Any takers to be the language team guinea pig?

@kwadronaut, I think there are several Dutch contributors potentially interested in the issue of consistency and quality control in Dutch technical translation. I spoke briefly with pljmn (very active on TX) about this awhile ago and they may be interested in contributing to this effort or if not, in providing constructive feedback on the approach. SilverXp may also be up for participating.

I totally missed your update/question @erinm, sorry. IĀ“m not sure if Dutch would be a god guinea pig, while strolling through the Mozilla guide, I noticed some brokennes, and (part of) a reply was

ā€œDo note that this guide itself is just a partial copy of the one on mozilla-nl.org, both are heavily outdated, and not worth much these days IMO. Plans to revise them have been there for a while, but with low priority.ā€

The Dutch style guide also misses a handful of things, those will be taken for granted by most (units for example). So all in all, Iā€™d expect to update the wordlist(s), rip out or rewrite the general guide related to brandingā€¦ Best would be to setup a meeting with pljmn, SilverXp and whomever else is interested. Things like gender neutrality arenĀ“t present in the current guides, so figuring out whatĀ“s missing and relevant would also be on the to-do list.

1 Like

In your opinion, would the guide still serve as a useful base for development? Or would it be just as much work, or less to start from scratch?

Also adding that @drashti4 has been contributing to the experiment in framagit. Iā€™m still dealing with a learning curve here, so welcome the perspectives of individuals with more familiarity with Git.

It definitely still has a lot of value. ItĀ“s also not too big, while rewriting from scratch will probably leave holes that should be addressed. This community has itĀ“s own jargon thatĀ“s (partly) missing from the existing wordlists, some of which can flow back upstream. I can imagine that every language team can/should have a look at what Mozilla has done and what they need. DutchĀ“ needs (changes) are minimal. It can be a tiresome process to learn about the different existing communities (KDE, Gnome, Wordpressā€¦), but itā€™s very worthwhile to interact and pick what you can learn from them.

@drashti4 and I chatted and thought maybe an effective way forward is to meet and test out the process of contributing to the guide together, providing feedback and asking questions in the process. If individuals are interested, Iā€™m open to meet this Friday the 8th or the following Friday the 15th with the possibility of using the open LocLab community meeting hour for discussion.

1 Like

Is there a URL to learn about this meeting? It looks like I missed it and it sounds interesting :slight_smile:

1 Like

For now I have just been announcing in community updates in the Google Group. The next meeting is on the 15th of June at 14.00 UTC in meet.jit.si/L10nLab.

1 Like