Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Japanese Translation Progress #4

Open
tesseralis opened this issue Jan 31, 2019 · 122 comments

Comments

@tesseralis
Copy link
Member

commented Jan 31, 2019

For New Translators

To translate a page:

  1. Check that no one else has claimed your page in the checklist and comments below.
  2. Comment below with the name of the page you would like to translate. Take only one page at a time.
  3. Submit a PR!

Please check the style guide and word list to make sure translations are written in a consistent manner.

Also check out the Crowdin repository before starting translation of a new article. Click and open each article to see how much work has been actually done. "0%" in the index page does not mean the article has not been translated!

大部分の記事には、既にCrowdinに7~8割方完成した(というか100%完成してたんだけど2018年半ば以降から放置されたためにちょっと古くなった)翻訳があります。翻訳を始める前にそちらをチェックし、使えると思ったら使ってください。目次ページのプログレスバーが「0%」となっていたとしても、それは「過去に一旦確定された記事から差分で更新する作業の進捗が0%」みたいな意味らしく、翻訳がされていないという意味ではありません!

For Reviewers

Before starting your thorough review, please make a comment in the individual PR page so that too many duplicate suggestions/comments will not happen at the same time. "Reviewers" section at the right means "those people will review eventually".

Work List

(🏃 Work in Progress; 👀 In Review)

Core Pages

To do before releasing as an "official" translation. Please translate these pages first.

Basics

API Reference

Navigation

These are the navigation links that appears in the sidebar. Possibly wait until
the corresponding sections are translated to do these.

Next Steps

These are the next most important translations, ordered by importance:

Installation

Hooks

Everyone is hooked on hooks! People are really excited for these and it would be great for them to be translated.

  • Hooks (@smikitky)
    • Introducing Hooks #18
    • Hooks at a Glance #48
    • Using the State Hook #51
    • Using the Effect Hook #54
    • Rules of Hooks #64
    • Building Your Own Hooks #65
    • Hooks API Reference #130
    • Hooks FAQ #115

Warnings

These are the pages that you get when you click the links in the console (e.g. https://reactjs.org/warnings/dont-call-proptypes.html). People tend to search these, so please don't translate the error message itself.

  • Warnings (@uehaj) #50
    • dont-call-proptypes
    • invalid-aria-prop
    • legacy-factories
    • refs-must-have-owner
    • special-props
    • unknown-prop
    • invalid-hook-call-warning (new)

Advanced Guides

FAQ

Contributing

Priority: Low

Components

Components in src/components that have some text in them.

  • CodeEditor
  • CodeExample
  • ErrorDecoder
  • LayoutFooter #151
  • LayoutHeader
  • MarkdownPage

Additional Translations

These are not the primary translation targets.

  • Blog
  • Community

@tesseralis tesseralis changed the title Translation Progress Japanese Translation Progress Jan 31, 2019

@tesseralis tesseralis referenced this issue Jan 31, 2019
8 of 8 tasks complete
@Naturalclar

This comment has been minimized.

Copy link
Contributor

commented Jan 31, 2019

I'd like to work on Composition vs Inheritance

@smikitky

This comment has been minimized.

Copy link
Member

commented Jan 31, 2019

@Naturalclar Thank you! Probably you can use the Crowdin's work as a base. We have not established a formal reviewing process, but once you've made a PR, I or someone will take a look.

@smikitky smikitky pinned this issue Jan 31, 2019

@potato4d

This comment has been minimized.

Copy link
Member

commented Jan 31, 2019

As a model of translation, I think I want to work on a tutorial

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Jan 31, 2019

@potato4d have you finished the glossary yet?

@potato4d

This comment has been minimized.

Copy link
Member

commented Jan 31, 2019

After I finished translating glossary, it was meant as an example of translation of that glossary!

@Naturalclar

This comment has been minimized.

Copy link
Contributor

commented Jan 31, 2019

@smikitky Thank you! I've made a PR for translation of composition-vs-inheritance based on the translation on Crowdin
#5

@sasurau4

This comment has been minimized.

Copy link
Contributor

commented Feb 1, 2019

I'd like to work on Lifting State Up 👍

@smikitky

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

@potato4d Tutorial is one of the longest (and the most outdated) articles, and I believe your top priority for the next few days is to set up the bot. According to this comment, we need to establish a good workflow in a few days. Do you think you can handle both?

@sasurau4 Thank you!

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

@smikitky I think I'll be able to handle the bot myself -- we'll probably end up forking che-tsumi so it'll be easier to customize. @potato4d I would still like your help though -- I'll ask you some questions in email :)

@smikitky

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

For now,

  • Please do NOT modify link URLs in the original markdown even if there is a Japanese equivalent (using the Japanese version of an MDN/Wikipedia article, etc)
  • Please do NOT worry about anchor names, just translate the heading text (reactjs/reactjs.org#1608). This means some inter-page links won't work now, but we'll fix this afterwards.
@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

@smikitky I think you can edit my issue with these additional notifications.

Why shouldn't we translate the external links? I'm curious because someone on the Spanish translation team was asking.

@smikitky

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

@tesseralis I just wanted to play it safe until members of all forks reach some consensus about this :) We may come up with some automated solution.

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

I don't think so... It depends on whether those links exist / are high quality in each language, right? Like, Japanese Wiki might have a good article on "declarative programming" but maybe Russian doesn't?

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

Will think of a way to do general translation guidelines.

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

@potato4d do you have any thoughts from your experience with vue?

@smikitky

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

This is something we have to eventually discuss in the main repo. But React doc currently has literally hundreds of English-only external links (to Stack Overflow questions, YouTube videos, personal blog articles, Tweets, etc), which is atypical as the official documentation of a large library. I feel changing only a small part of them on an ad-hoc basis might not be a manageable option at least in the short term.

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

Sure, do you want to leave a comment on the main issue? Or if you want it to just be among translators I created a parent group for the internationalization effort: https://github.com/orgs/reactjs/teams/reactjs-org-internationalization

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 1, 2019

I don't think it's "ad hoc" to have the rule:

"If this link is for technical documentation and there is a high quality translation, link to the translation. Otherwise, keep the original English link."

There are copious links to non-translateable things like YouTube videos and StackOverflow and I think that is a issue to be handled by the English repo writers, but I don't think that should be a blocker.

@potato4d

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

@smikitky
Since it seems better to prioritize the setting of Bot, it may be better to ask smikitky for the tutorial.
Could you please?

@tesseralis @smikitky

In the case of Vue document, when I find a document translated by MDN etc., I am changing the link.

For example, most people reading Japanese documents are Japanese.
And, in most cases the Japanese are seeking Japanese document.

@potato4d

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

I just submitted a pull request to introduce TextLint.
If you have an opinion, please comment.

#6

@smikitky

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

Okay, I'll take care of the tutorial.

@Nkzn

This comment has been minimized.

Copy link
Contributor

commented Feb 1, 2019

May I take Thinking in React ?

@smikitky

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

@Nkzn Yes, please!

@lightnet328

This comment has been minimized.

Copy link
Contributor

commented Feb 1, 2019

May I take React and React.Component?

@potato4d

This comment has been minimized.

Copy link
Member

commented Feb 1, 2019

@lightnet328
Yes, please!
thanks!

@ossan-engineer

This comment has been minimized.

Copy link
Contributor

commented Feb 1, 2019

Can I take FAQ ?

@37108

This comment has been minimized.

Copy link
Contributor

commented Feb 13, 2019

I'd like to work Versioning Policy
can I take this?

@oimo23

This comment has been minimized.

Copy link
Contributor

commented Feb 14, 2019

Hi, I'd like to work on How to Contribute

@hand-dot

This comment has been minimized.

Copy link
Contributor

commented Feb 14, 2019

Hi, Can I take Design Principles ?

@thayashi

This comment has been minimized.

Copy link
Contributor

commented Feb 14, 2019

May I take Codebase Overview?

@km-tr

This comment has been minimized.

Copy link
Contributor

commented Feb 17, 2019

#4 (comment) Virtual DOM and Internals
I wanted to translate, but since my work has become busy, can you reassign it to other people?
@smikitky @tesseralis

@syug

This comment has been minimized.

Copy link
Contributor

commented Feb 17, 2019

Then, may I take Virtual DOM and Internals?

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Feb 19, 2019

@smikitky how goes the tutorial?

Good work everyone! Just a couple more reviews and we're ready to go!

Also, look what @bvaughn set up: https://ja.reactjs.org

@potato4d

This comment has been minimized.

Copy link
Member

commented Feb 21, 2019

Since https://ja.reactjs.org became available, I'll translate sequential navigation.

@y-yeah

This comment has been minimized.

Copy link
Contributor

commented Mar 1, 2019

Hey guys, may I take Implementation Notes?

@smikitky

This comment has been minimized.

Copy link
Member

commented Mar 1, 2019

"Core Pages" の翻訳が終わりました!

@tesseralis

This comment has been minimized.

Copy link
Member Author

commented Mar 2, 2019

おめでとうございます! 🎉

screen shot 2019-03-01 at 4 29 45 pm

@smikitky

This comment has been minimized.

Copy link
Member

commented Mar 20, 2019

@Naturalclar @y-yeah How is the progress? If you don't have enough time, we can release the assignment and have others do the job.

@y-yeah

This comment has been minimized.

Copy link
Contributor

commented Mar 20, 2019

@Naturalclar @y-yeah How is the progress? If you don't enough time, we can release the assignment and have others do the job.

Implementation notes will be done this Friday. Sorry about taking a while!

@y-yeah

This comment has been minimized.

Copy link
Contributor

commented Mar 22, 2019

Finished translating implementation notes!

@Naturalclar

This comment has been minimized.

Copy link
Contributor

commented Mar 22, 2019

@Naturalclar @y-yeah How is the progress? If you don't have enough time, we can release the assignment and have others do the job.

Sorry for the delay! I'll work on it tonight (JST) 🙇

@G-N555

This comment has been minimized.

Copy link
Contributor

commented May 3, 2019

Can I translate external-resources?
Is this required to do that?

@potato4d

This comment has been minimized.

Copy link
Member

commented May 6, 2019

@G-N555
Yes, please!

@G-N555

This comment has been minimized.

Copy link
Contributor

commented May 10, 2019

@potato4d
I've done translation! Please check when you have time.
Btw, can I translate the rest of community after that?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
You can’t perform that action at this time.