ruby / ruby/www.ruby-lang.org

[Update]www.r-l.org zh_cn status

Open
#1,194 4 comments 0 reactions 0 assignees View on GitHub

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
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
    1. Fork this repository.
    1. Clone git@github.com:ruby/www.ruby-lang.org.git to your local machine.
    1. 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)
    1. Get latest master branch: git pull origin master
    1. Pick a task from above
    1. Create a descriptive feature branch. (zh_cn/update-installation)
    1. Find the file and start translating.
      if the doc does not exist, copy en one to corresponding location under zh_cn.
      if doc already exists, compare with en and update to latest.
      If file is too big, you can also translate/update some part of it.
    1. Preview
      bundle to install dependencies. Then run rake preview to 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.
    1. Finished translation, add and commit it.
      git add and git commit -v, please write a descriptive commit message, you need to include (zh_cn) in the commit message.
    1. Push to your fork: git push forked [your-descriptive-feature-branch-name].
    1. Visit https://github.com/ruby/www.ruby-lang.org, you shall see there is a create a pull request button.
    1. Click button to create a Pull Request with descriptive title and body. Link back to this PR by putting Related #1074 in your PR body.
    1. Run rake preview and post a screenshot in the pull request.

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
Style of Translation

Please refer to https://github.com/sparanoid/chinese-copywriting-guidelines

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.