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

Translate Hooks FAQ #123

Merged
merged 16 commits into from Feb 4, 2020
Merged

Translate Hooks FAQ #123

merged 16 commits into from Feb 4, 2020

Conversation

dummyeuy
Copy link
Contributor

Translating content/docs/hooks-faq.md by dummyeuy with minor revisions

Referenced from this #1 (comment)

@netlify
Copy link

netlify bot commented Oct 24, 2019

Deploy preview for idreactjs ready!

Built with commit fa44738

https://deploy-preview-123--idreactjs.netlify.com

@netlify
Copy link

netlify bot commented Oct 24, 2019

Deploy preview for id-reactjs ready!

Built with commit fa44738

https://deploy-preview-123--id-reactjs.netlify.com

Copy link
Member

@resir014 resir014 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dummyeuy Thanks! This is my first pass for the review. Will look into it again later tonight.

There some more issues littered across the translation that I didn't put in as a suggested change. Please look into them:

  • Please note the ordering of nouns and adjectives between English and Bahasa Indonesia. In many cases, they need to be swapped around. (e.g. DOM element -> elemen DOM)
  • Names that reference features within React (e.g. React DOM, React Hooks, etc) don't need to be italicised
    • If you use Hooks on its own, you can italicise it, but if used together with React (e.g. React Hooks), no need to be italicised.
  • Abbreviations in foreign languages need not be italicised. Reference: https://twitter.com/ivanlanin/status/898520073224167424
  • Function/method names inside code blocks (e.g. useState, componentDidMount) don't need to be italicised.

content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
@dummyeuy
Copy link
Contributor Author

Dear @resir014 my latest commit as you can see on https://github.com/reactjs/id.reactjs.org/pull/123/files/b293ec3a432e9bd035f16b07b719b873d108c2e0 is up. This is according to your feedback today (11.00 A.M, Oct 25).

I don't need to create new pull request, right?

Thank you

@dummyeuy dummyeuy closed this Oct 28, 2019
@resir014
Copy link
Member

@dummyeuy You do not need to close the pull request, as you can continue making changes here until everything is good.

@dummyeuy
Copy link
Contributor Author

@dummyeuy You do not need to close the pull request, as you can continue making changes here until everything is good.

Do I need to reopen this pull request?

@dummyeuy dummyeuy mentioned this pull request Oct 31, 2019
@resir014
Copy link
Member

resir014 commented Nov 2, 2019

Yes.

@resir014
Copy link
Member

resir014 commented Nov 3, 2019

Before I reopen this PR, do I have to close this JSX-in-depth PR or wait for that JSX-in-depth PR merged then reopen this one?

If you don't know how to remove the commit history to delete the Hooks FAQ file, then you can just close that PR and reopen. I'll only merge completed PRs.

@dummyeuy
Copy link
Contributor Author

dummyeuy commented Nov 3, 2019

Yes.

@resir014
Before I reopen this PR, do I have to close this JSX-in-depth PR or wait for that JSX-in-depth PR merged then reopen this one?

@dummyeuy
Copy link
Contributor Author

dummyeuy commented Nov 3, 2019

Before I reopen this PR, do I have to close this JSX-in-depth PR or wait for that JSX-in-depth PR PR merged then reopen this one?

If you don't know how to remove the commit history to delete the Hooks FAQ file, then you can just close that PR and reopen. I'll only merge completed PRs.

I've already closed Hooks API PR and I can't reopen the PR because of the JSX-in-depth PR is still open -not merged yet

@dummyeuy dummyeuy reopened this Dec 2, 2019
@dummyeuy
Copy link
Contributor Author

dummyeuy commented Dec 3, 2019

Excuse me @resir014 , do I have to make a change in this PR too?
*I've just reopened this PR

@resir014
Copy link
Member

resir014 commented Dec 5, 2019

@dummyeuy I'm not sure I understand your question 😅 What do you mean by that?

@dummyeuy
Copy link
Contributor Author

dummyeuy commented Dec 5, 2019

@dummyeuy I'm not sure I understand your question 😅 What do you mean by that?

@resir014 I mean "do I have to make some changes to this PR? because I'd closed this PR before - now I've just reopened this PR"

@resir014
Copy link
Member

resir014 commented Dec 6, 2019

@dummyeuy

do I have to make some changes to this PR? because I'd closed this PR before - now I've just reopened this PR

Yes. However, on a1a815e, I see that you've deleted your work on the Hooks FAQ page and replaced it with the merged translation from the other PR (JSX in-depth). I don't understand what you're doing here 😅

@dummyeuy
Copy link
Contributor Author

dummyeuy commented Dec 6, 2019

@dummyeuy

do I have to make some changes to this PR? because I'd closed this PR before - now I've just reopened this PR

Yes. However, on a1a815e, I see that you've deleted your work on the Hooks FAQ page and replaced it with the merged translation from the other PR (JSX in-depth). I don't understand what you're doing here 😅

Hello @resir014 , I brought back my deleted work on Hooks FAQ before the JSX-in-depth PR.

You may check it out and review the translated version of Hooks FAQ on my latest commit

Thank you

@dummyeuy dummyeuy changed the title Translation result of Hooks FAQ by dummyeuy with minor revisions Translation of Hooks FAQ with minor revisions Dec 10, 2019
Copy link
Member

@resir014 resir014 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here's my first pass of the review (up to the Adoption Strategy section). There are some issues to address beyond all the suggested changes:

1.

Please remove all italicisation of abbreviations of names (e.g. API, DOM). Abbreviations for foreign names don't need to be translated. https://twitter.com/ivanlanin/status/898520073224167424

2.

In all code syntax blocks, please remove the spaces between the language name and line numbers.

image

This breaks syntax highlighting on the final rendered page.

image

content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
content/docs/hooks-faq.md Outdated Show resolved Hide resolved
@dummyeuy
Copy link
Contributor Author

dummyeuy commented Dec 18, 2019

Thank you @resir014 for your review and suggested changes.

  • I have removed all italicization of abbreviations of names (e.g. API, DOM)
  • I have removed all spaces between the language name and line numbers

Please kindly review my latest commit :)
Thank you again

Copy link
Member

@resir014 resir014 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Finished review for the second half of the page. Please take a look @dummyeuy.

  • Please also don't forget to re-check each headings inside the table of contents, and the actual headings themselves. Make sure there are no differences between them.

content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
content/docs/hooks-faq.md Show resolved Hide resolved
Copy link
Member

@resir014 resir014 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, please resolve any merge conflicts after you have fixed the translations.

@dummyeuy
Copy link
Contributor Author

All suggested corrections are applied, and the headings & table of contents are also updated.
Merge conflict's resolved.

Copy link
Member

@resir014 resir014 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All good. Thank you for your help!

@resir014 resir014 changed the title Translation of Hooks FAQ with minor revisions Translate Hooks FAQ Feb 4, 2020
@resir014 resir014 merged commit 19604f5 into reactjs:master Feb 4, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants