Contributing

By contributing to this project, you are agreeing to do so under these licenses: https://github.com/learnbyexample/ThinkRubyBuild#license

This issue manager will act as a guideline for contributing as well as for clarifying questions about them

• Reference book: https://greenteapress.com/thinkpython2/html/index.html
• Use only markdown, no html
  • This restriction is mainly because using html might prevent rendering the book using other tools which accept GitHub style markdown, but not its extensions.
  • This is causing issue to display math equations, worked around in some places using Ruby style expression, using images, etc. If necessary, html will be allowed
• Chapter/sections can be linked in other parts of the book using anchors. GitHub automatically creates anchors for headers (click icon to the left of headings). For example: https://github.com/learnbyexample/ThinkRubyBuild/blob/master/chapters_md/fruitful_methods.md#boolean-methods - to link this, use [Boolean methods](./fruitful_methods.md#boolean-methods) where filename is needed only when linking from another chapter
• Terms changed from Python to Ruby:
  • Function --> Method (except when referring to external definitions like mathematical functions)
  • List --> Array
  • Dictionary --> Hash
• Use issue manager (one issue manager to collate notes per chapter) to note down a few details before submitting a PR
  • mention if any chapter/section name has changed, this will be needed to correct links in other places
  • mention if any exercise cannot be translated - might be referred to in another chapter
  • etc
• Use xfig if you need to change an illustration. You'll need to use .fig files as input ( https://github.com/learnbyexample/ThinkRubyBuild/tree/master/book/figs) and output format needed is png

Đọc hướng dẫn đóng góp, sau đó kiểm tra các tệp chương trong chapters_md và các nguồn minh họa trong book/figs. Các đóng góp phải tuân theo các quy tắc Markdown và thuật ngữ đã nêu, đồng thời các thay đổi đối với chương hoặc các bài tập chưa được dịch phải được ghi chú trong trình quản lý issue; ở đây không xác định thay đổi tài liệu cụ thể nào.