Documents translation status overview

[hustcer]

The following table holds the overview of the Nushell docs’ writing and translation status. Welcome to participate in the translation of the docs. And please update the i18n-meta.json file after you have finished writing or translating the doc. Thanks

---

name	en	zh-CN	de	tr	ja	es	pt-BR	ru
3rdpartyprompts.md	Completed	f5987a8@hustcer	translated by @sebastian-xyz	-	-	-	-	-
README.md	Completed	fa90895@hustcer	-	-	cfc7b0d@YukiOnodera	-	-	translated by @Blezz-tech
advanced.md	In progress	-	-	-	-	-	-	-
aliases.md	Completed	51522d5@hustcer	translated by @sebastian-xyz	-	-	-	-	-
background_task.md	In progress	-	f08ae29@petrisch	-	-	-	-	-
cheat_sheet.md	In progress	-	-	-	-	-	-	-
coloring_and_theming.md	Completed	1b7d01a@hustcer	93859d1@petrisch	-	-	-	-	-
coming_from_bash.md	Completed	d6efb9a@hustcer	translated by @sebastian-xyz	-	-	-	-	-
coming_from_cmd.md	In progress	-	c39efa0@petrisch	-	-	-	-	-
coming_to_nu.md	In progress	-	c39efa0@petrisch	-	-	-	-	-
command_signature.md	In progress	-	696cb4f@petrisch	-	-	-	-	-
configuration.md	Completed	d6efb9a@hustcer	translated by @sebastian-xyz	-	-	-	-	-
control_flow.md	Completed	-	-	-	-	-	-	-
creating_errors.md	Completed	ae23eeb@hustcer	-	-	-	-	-	-
custom_commands.md	Completed	d6efb9a@hustcer	translated by @sebastian-xyz	-	-	-	-	-
custom_completions.md	Completed	f5987a8@hustcer	5993a92@petrisch	-	-	-	-	-
dataframes.md	Completed	129cc2d@hustcer	-	-	-	-	-	-
default_shell.md	In progress	-	-	-	-	-	-	-
design_notes.md	In progress	-	-	-	-	-	-	-
environment.md	Completed	d6efb9a@hustcer	-	-	-	-	-	-
escaping.md	Completed	f5987a8@hustcer	translated by @sebastian-xyz	-	-	-	-	-
explore.md	In progress	-	-	-	-	-	-	-
externs.md	Completed	b6c91ca@hustcer	-	-	-	-	-	-
getting_started.md	In progress	-	c39efa0@petrisch	-	cfc7b0d@YukiOnodera	-	-	-
hooks.md	In progress	562cad2@hustcer	13ed311@petrisch	-	-	-	-	-
how_nushell_code_gets_run.md	In progress	-	-	-	-	-	-	-
installation.md	Completed	73ef7f3@hustcer	translated by @sebastian-xyz	-	-	-	-	-
introduction.md	In progress	-	-	-	-	-	-	-
line_editor.md	Completed	b6c91ca@hustcer	-	-	-	-	-	-
loading_data.md	Completed	fa90895@hustcer	0c788ac@petrisch	-	-	-	-	-
metadata.md	Completed	ae23eeb@hustcer	83d74f9@Roshanjossey	-	-	-	-	-
modules.md	Completed	73ef7f3@hustcer	-	-	-	-	-	-
moving_around.md	Completed	1b7d01a@hustcer	cfba017@petrisch	-	-	-	-	-
nu_as_a_shell.md	In progress	-	c39efa0@petrisch	-	-	-	-	-
nu_fundamentals.md	In progress	-	c39efa0@petrisch	-	-	-	-	-
nushell_map.md	Completed	1b7d01a@hustcer	-	-	-	-	-	-
nushell_map_functional.md	Completed	73ef7f3@hustcer	-	-	-	-	-	-
nushell_map_imperative.md	Completed	73ef7f3@hustcer	-	-	-	-	-	-
nushell_operator_map.md	Completed	ae23eeb@hustcer	-	-	-	-	-	-
operators.md	Completed	1b7d01a@hustcer	c39efa0@petrisch	-	-	-	-	-
overlays.md	In progress	51522d5@hustcer	2a917ad@petrisch	-	-	-	-	-
parallelism.md	Completed	ae23eeb@hustcer	-	-	-	-	-	-
pipelines.md	Completed	6f61fad@hustcer	931d724@petrisch	-	-	-	-	-
plugins.md	Completed	ae23eeb@hustcer	translated by @sebastian-xyz	-	-	-	-	-
programming_in_nu.md	In progress	-	c39efa0@petrisch	-	-	-	-	-
quick_tour.md	In progress	-	-	-	fcf0d7c@yukitomoda	-	-	-
regular_expressions.md	Completed	b6c91ca@hustcer	-	-	-	-	-	-
scripts.md	Completed	fa90895@hustcer	931d724@petrisch	-	-	-	-	-
shells_in_shells.md	Completed	f5987a8@hustcer	-	-	-	-	-	-
standard_library.md	In progress	-	-	-	-	-	-	-
stdout_stderr_exit_codes.md	Completed	73ef7f3@hustcer	-	-	-	-	-	-
style_guide.md	In progress	-	-	-	-	-	-	-
table_of_contents.md	Completed	1b7d01a@hustcer	-	-	-	-	-	-
testing.md	In progress	-	-	-	-	-	-	-
thinking_in_nu.md	Completed	fa90895@hustcer	c39efa0@petrisch	-	-	-	-	-
types_of_data.md	Completed	73ef7f3@hustcer	-	-	-	-	-	-
variables_and_subexpressions.md	Completed	1b7d01a@hustcer	translated by @sebastian-xyz	-	-	-	-	-
working_with_lists.md	Completed	73ef7f3@hustcer	ad03c8d@petrisch	-	-	-	-	-
working_with_strings.md	Completed	5d093e2@hustcer	0c788ac@petrisch	-	-	-	-	-
working_with_tables.md	Completed	73ef7f3@hustcer	ad03c8d@petrisch	-	-	-	-	-

Possible status values: -,Completed,In Progress,Being translated by @ABC, commit_id@author or simply a COMMIT ID indicate your translation end to.

[hustcer]

@sebastian-xyz Hi, Thanks for your contribution, could you please update i18-meta.json file in your next PR? for example:

{
    "name": "aliases.md",
    "en": "In progress",
    "de": "Translated by @sebastian-xyz ",
    "zh-cn": "-",
    "ja": "-",
    "es": "-",
    "pt-BR": "-"
  },

Then I can update the content of this table in time.

[hustcer]

Translation status has been updated

[hustcer]

After this PR: #408, it's recommend to use commit_id@author or simply a COMMIT-ID to indicate your translation end to the specified commit, then you can use command like nu ./i18n.nu outdated zh-CN to check the outdated translations(documents have been changed after your last translation) for the specified locale.

[hustcer]

For those who want to translate the nushell docs, here is a Translation Guide for you.
Thanks for your contribution!

[petrisch]

@sebastian-xyz Can you have a look here: petrisch
Maybe I can contribute some things from time to time, but it should fit in with the rest, so I hesitate to make a PR.

[sebastian-xyz]

@petrisch From reading through it I noticed you used 'wir' as in the english version. I tried to avoid that since it is not that common in german. Otherwise I didn't notice anything that I would change or that varies from the way I did it. But it's also fine like this. Thanks! Feel also free to ping me on discord if you've got any other questions while translating :)

[hustcer]

@petrisch It's not recommend to change the file name after translation, change the file name will cause some code formatting issue, and may make ./i18n.nu script fail

[petrisch]

@hustcer thats one thing I was wondering about, since now in the german translate there is variablen_und_unterausdruecke.md which is a filename change.
@sebastian-xyz Thanks for the comment, I'm not on discord, but I will ping you first maybe in my fork before doing any PR

[Kissaki]

Possible status values: -,Completed,In Progress,Being translated by @abc, commit_id@author or simply a COMMIT ID indicate your translation end to.

What does Completed and In Progress on EN mean? Looks like column EN is Complete when any one translation exists? If so, I find that very misleading. EN content completeness has nothing to do with translations.

There seems to be at least two grammatical errors in or simply a COMMIT ID indicate your translation end to.

[Kissaki]

I see the Complete and In Progress values on en are in the i18n-meta.json file as well. I still don't understand the intention or how they make sense.

[hustcer]

What does Completed and In Progress on EN mean? Looks like column EN is Complete when any one translation exists? If so, I find that very misleading. EN content completeness has nothing to do with translations.

Completed in EN means the doc has been finished and won't change in the near future, and it's safe to translate; In Progress means the doc is still in writing and may change quite a lot, it's not safe to translate yet. I admit that it's misleading and the status may outdated.

There seems to be at least two grammatical errors in or simply a COMMIT ID indicate your translation end to.

English is not my native language, glad you can correct me.

[Kissaki]

What are you trying to say with it? What is the commit id supposed to be for? The commit that created the translation? The last commit that made changes to the translation?

[Kissaki]

I suggest some changes in PR #1431 - it also drops the confusion by dropping the elaboration.

[hustcer]

What are you trying to say with it? What is the commit id supposed to be for? The commit that created the translation? The last commit that made changes to the translation?

Supposing you are in nu docs repo and going to translate book/configuration.md doc from commit id: b985c65, and you finish the translation some time. And a few days later the nu docs repo has lots of new commits, the book/configuration.md has been updated too, you may want to update your translation, but what's changed to the original doc after your last translation? You can use git diff b985c653da book/configuration.md to see what's changed and update your translation according to the changes. The commit id: b985c65 is what supposed to be add to the i18n-meta.json

[Kissaki]

ah, so the base ref of the original text [state]

Then I assume for commit@author the commit is used that way as well. I interpreted it differently.

[Kissaki]

The post and table has not been updated since January.