[Update]www.r-l.org zh_cn status
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 944
- Forks
- 673
- Avg merge
- 2d 6h
- Merged PRs (30d)
- 9
Description
This is an updated list of https://github.com/ruby/www.ruby-lang.org/issues/1074 which lists the things left to do. Please feel free to take tasks 😃
Please do leave a comment if you want to work on some of the things to avoid people double work on the same thing. 😅
Places that need your help 😢
- Page footer and possibly more localizations in _config.yml
Pages
- About https://www.ruby-lang.org/en/about @hlcfan
- About/logo https://www.ruby-lang.org/en/about/logo @hlcfan
- About/website (new!) https://www.ruby-lang.org/en/about/website @hlcfan
- Documentation https://www.ruby-lang.org/en/documentation
- Documentation/installation (new!) https://www.ruby-lang.org/en/documentation/installation @tzwm
- Security https://www.ruby-lang.org/en/security (minor changes; not to translate: the list of
More known issues) @cursorzz - many more pages have been changed over the years and should be updated
News (Please update from newest first!)
- 2014/10/27/rexml-dos-cve-2014-8080 @AndyHelix
- 2014/09/02/Railscamp-Koeln
- 2014/07/01/eol-for-1-8-7-and-1-9-2 @diguage
- 2014/06/16/rubyworld-conference-2014-speaker-invite @diguage
- 2016 Fukuoka Ruby Award Competition - Entries to be judged by Matz @Zane5
How to help
-
- Fork this repository.
-
- Clone
git@github.com:ruby/www.ruby-lang.org.git toyour local machine.
- Clone
-
- Add your forked remote:
git remote add [your_username] git@github.com:[your_username]/www.ruby-lang.org.git(Replace[your_username]with your GitHub username)
- Add your forked remote:
-
- Get latest master branch:
git pull origin master
- Get latest master branch:
-
- Pick a task from above
-
- Create a descriptive feature branch. (
zh_cn/update-installation)
- Create a descriptive feature branch. (
-
- Find the file and start translating.
if the doc does not exist, copyenone to corresponding location underzh_cn.
if doc already exists, compare withenand update to latest.
If file is too big, you can also translate/update some part of it.
- Find the file and start translating.
-
- Preview
bundleto install dependencies. Then runrake previewto preview the website (May take 10 minutes!). Visit localhost:4000 and go to corresponding location of the site you're working on to see if anything goes wrong. This is a Jekyll powered website, you can know more about Jekyll here.
- Preview
-
- Finished translation, add and commit it.
git addandgit commit -v, please write a descriptive commit message, you need to include(zh_cn)in the commit message.
- Finished translation, add and commit it.
-
- Push to your fork:
git push forked [your-descriptive-feature-branch-name].
- Push to your fork:
-
- Visit https://github.com/ruby/www.ruby-lang.org, you shall see there is a create a pull request button.
-
- Click button to create a Pull Request with descriptive title and body. Link back to this PR by putting
Related #1074in your PR body.
- Click button to create a Pull Request with descriptive title and body. Link back to this PR by putting
-
- Run
rake previewand post a screenshot in the pull request.
- Run
Now wait your Pull Request to get reviewed! 🎊 Thank you! 🙇
If you reviewed a pull request, and think it is good to merge, can drop a comment like: 👍 , :shipit: , etc.
If you are not familiar with Git, you can try git-it. 😉
Examples
- Translate Page example: Example 1, Example 2
- Update outdated page example: Example 1, Example 2
- Fix typo example: Example 1, Example 2
- Translate news example: Example 1, Example 2
Style of Translation
Please refer to https://github.com/sparanoid/chinese-copywriting-guidelines
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the unchecked zh_cn pages listed in the issue, including Security and the specified News entries, and compare them with their English counterparts; _config.yml is also mentioned for localization updates. For missing documents, use the corresponding en path, then run bundle and rake preview to inspect the result at localhost:4000. Done means the selected Chinese translation is current and previews correctly.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- git, jekyll, ruby
- Domain
- content, documentation, localization, web-dev
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100