Need people to give feedback

ruby-talk
1

Hello All,

I am porting my Ruby book to HTML here https://i-love-ruby.gitlab.io/ , I
would be very happy if people who want to learn Ruby can use it and give me
feedback, possibly negative ones so that I can improve my book.

···

--
Karthikeyan A K

Founder of Code Tribe https://is.gd/codetribe
Author of https://mindaslab.github.io/I-Love-Ruby/

2

First feedback, is you should stick with the ruby style guide in your code while you explaining things

Senior Information Security Engineer
OSCE, GWAPT, CEH, OSCP, RHCE, CCNA, MCITP-EA

···

On Oct 17 2018, at 8:26 pm, Karthikeyan A K <77minds@gmail.com> wrote:

Hello All,

I am porting my Ruby book to HTML here https://i-love-ruby.gitlab.io/ (I Love Ruby - Get started with the greatest programming language made for humans.) , I would be very happy if people who want to learn Ruby can use it and give me feedback, possibly negative ones so that I can improve my book.

--
Karthikeyan A K

Founder of Code Tribe https://is.gd/codetribe (https://link.getmailspring.com/link/1539814385.local-772e927e-5071-v1.4.2-f587b7b7@getmailspring.com/1?redirect=https%3A%2F%2Fis.gd%2Fcodetribe&recipient=cnVieS10YWxrQHJ1YnktbGFuZy5vcmc%3D\)
Author of I Love Ruby - Free Ruby programming book (I Love Ruby - Free Ruby programming book)

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

3

The ToC might be cognitively overwhelming; an expandable index might be a
way to gradually expand sections.

Tips about security might help as later, end-of-chapter content, such as
untrusted input, eval/exec, YAML, Marshal. Make it clear almost all Ruby
gems are cryptographically-unsigned and offer zero security... a major APT
risk.

- Explain how $LOAD_PATH works
- The difference between load and require
- Write tests first and small refactors
- DRb still works
- Pry > irb
- How to make a Rails railtie gem
- How to make a cli gem
- minitest specs

Intermediate topics:

- parallel gem
- ruby-progressbar
- How to use rake tasks instead of a makefile

Advanced topics:

- Writing a native C extension
- Why chruby (+ ruby-install) is superior to rvm: It doesn't patch cd and
is completely environment-variable based
- foreman?, god? => foreman_god
- sequel for projects that don't require full AR
- trailblazer + rails
- concurrent-ruby
- Making UI widgets with ncurses
- absolute_time instead of benchmark
- More performance? Try crystal

···

On Wed, Oct 17, 2018 at 10:27 AM Karthikeyan A K <77minds@gmail.com> wrote:

Hello All,

I am porting my Ruby book to HTML here https://i-love-ruby.gitlab.io/ , I
would be very happy if people who want to learn Ruby can use it and give me
feedback, possibly negative ones so that I can improve my book.

--
Karthikeyan A K

Founder of Code Tribe https://is.gd/codetribe
Author of I Love Ruby - Free Ruby programming book

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

4

I am porting my Ruby book to HTML here https://i-love-ruby.gitlab.io/ , I would be very happy if people who want to learn Ruby can use it and give me feedback, possibly negative ones so that I can improve my book.

This is very unfair of me but I find the book hard to read because it’s not written in grammatically correct English. I doubt that would stop anyone learning Ruby from it, so please take this with a grain of salt!

Random example: “With irb we can do easy math.” I think it would be better English to say, “With irb we can do math easily” – which in this case also happens to clarify the meaning; presumably you do not mean that we can only do easy sums using irb…

Click here to view Company Information and Confidentiality Notice.<http://www.jameshall.co.uk/index.php/small-print/email-disclaimer&gt;

Please note that we have updated our privacy policy in line with new data protection regulations. Please refer to our website to view the ways in which we handle your data.

5

Thanks for this list. Lots of useful topics to look into.

Ketan

···

On 17/10/2018 23:35, Barry Allard wrote:

The ToC might be cognitively overwhelming; an expandable index might
be a way to gradually expand sections.

Tips about security might help as later, end-of-chapter content, such
as untrusted input, eval/exec, YAML, Marshal. Make it clear almost all
Ruby gems are cryptographically-unsigned and offer zero security... a
major APT risk.

- Explain how $LOAD_PATH works
- The difference between load and require
- Write tests first and small refactors
- DRb still works
- Pry > irb
- How to make a Rails railtie gem
- How to make a cli gem
- minitest specs

Intermediate topics:

- parallel gem
- ruby-progressbar
- How to use rake tasks instead of a makefile

Advanced topics:

- Writing a native C extension
- Why chruby (+ ruby-install) is superior to rvm: It doesn't patch cd
and is completely environment-variable based
- foreman?, god? => foreman_god
- sequel for projects that don't require full AR
- trailblazer + rails
- concurrent-ruby
- Making UI widgets with ncurses
- absolute_time instead of benchmark
- More performance? Try crystal

On Wed, Oct 17, 2018 at 10:27 AM Karthikeyan A K <77minds@gmail.com > <mailto:77minds@gmail.com>> wrote:

    Hello All,

    I am porting my Ruby book to HTML here
    https://i-love-ruby.gitlab.io/ , I would be very happy if people
    who want to learn Ruby can use it and give me feedback, possibly
    negative ones so that I can improve my book.

    --
    Karthikeyan A K

    Founder of Code Tribe https://is.gd/codetribe
    Author of I Love Ruby - Free Ruby programming book

    Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org
    <mailto:ruby-talk-request@ruby-lang.org>?subject=unsubscribe>
    <http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

Unsubscribe: <mailto:ruby-talk-request@ruby-lang.org?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk&gt;

6

I don't think it's unfair at all. English is a very difficult language to learn; even many native speakers don't know the rules. I'm pretty sure I don't know them but I go by what sounds right.

Talked to Packt a couple months ago, in the "Go Standard Library Cookbook" Chapter 1 was full of grammar and code errors. I am much less likely to buy another Packt book if they don't want to edit their work before selling it. Never really made it to Chapter 2.

The extra effort to edit the text to make it proper English will probably help people stay with it longer and learn more. If you feel Ruby deserves the effort I encourage you to work on the grammar.

···

On 10/18/18 3:51 AM, Andy Jones wrote:

I am porting my Ruby book to HTML here https://i-love-ruby.gitlab.io/ , I would be very happy if people who want to learn Ruby can use it and give me feedback, possibly negative ones so that I can improve my book.

<<<<<<<<

This is very unfair of me but I find the book hard to read because it’s not written in grammatically correct English. I doubt that would stop anyone learning Ruby from it, so please take this with a grain of salt!

Random example: “With irb we can do easy math.” I think it would be better English to say, “With irb we can do math easily” – which in this case also happens to clarify the meaning; presumably you do not mean that we can only do easy sums using irb…