Contribution

    Note: The code in this book is tested on Ruby version > 2.2.0

    There are several kinds of contributions that could help this book achieve the best results:

    • Contribution by adding tricky code.
    • Contribution by adding more explanation for existing code.
    • Contribution by enhancing the code quality or alternatives.
    • Contribution by enhancing the book quality:
      • Structure enhancements
      • Design enhancements
      • Ideas and requests
      • Any other
    • Contribution by spreading the book in social media and IS communities.
    • Contribution by adding more resources and references.
    • Contribution by donation.

    Please find all you need to know about GitBook and markdown editing in the section. As good start, you can refer to how to use it from official readme. You can easily use GitBook .

    1. Create a GitHub account.
    2. Fork .

    3. Clone GitHub forked RubyFu repository:

    4. Create a GitBook account.
    5. Go to and Sign-in with your GitBook account
    6. Press the Import button to import the cloned repository. Then, you’ll find it in the LOCAL LIBRARY tab.
    7. Start your awesome contribution.
    8. From GitBook editor, Sync your changes to the forked repository.
    9. From GitHub, send a Pull Request(PR) to the Master branch.

    Not sure where to start helping? Go to TODO list and check the unchecked items.

    Ruby code

    • Use the triple ticks followed by ruby then your code in between the to get ruby code highlighted. e.g.

    • Explain the main idea -with some details- of the code, if you explain every line that would be great but it’s not a must.
    • Choose the correct Module.
    • Make your title clear.
    • Use Text editor/ide for code identification before pasting your code.

    • Mention the source, if you copied or developed code that has been created by others; please mention the source in the footer. e.g.

      Then add the following to the footer

    • Try to use readable code, if you have to add more tricky/skilled code then explain it well.
    Command-line

    Use triple ticks to highlight your command-line. ex.

    To translate Rubyfu, make sure to

    • Create a new branch for your translation.
    • Add a sub-directory under Rubyfu’s root directory with the name of the language you will translate to.
    • Update the LANGS.md file
    • Copy and paste the content of folder to your language folder, then translate it.

    Please make sure to mark the repository as Watch to keep your translated efforts up-to-date.

    General contributions might be topic requests, proofreading, spelling, book organization and style. All these contributions are welcome; however, they have to be discussed on - especially things in regards to topics and/or book organization and styling. At the same time don’t hesitate to report even a single word observation about the book, it’s for you at the end of the day.