Discussion:
Need people to give feedback
Karthikeyan A K
2018-10-17 17:26:33 UTC
Permalink
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/
KING SABRI
2018-10-17 22:14:10 UTC
Permalink
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
Post by Karthikeyan A K
Hello All,
--
Karthikeyan A K
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk>
Barry Allard
2018-10-17 22:35:13 UTC
Permalink
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
Post by Karthikeyan A K
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/
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk>
Ketan Patel
2018-10-18 08:43:30 UTC
Permalink
Thanks for this list. Lots of useful topics to look into.

Ketan
Post by Barry Allard
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
- parallel gem
- ruby-progressbar
- How to use rake tasks instead of a makefile
- 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
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/
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-talk>
Andy Jones
2018-10-18 07:51:55 UTC
Permalink
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>

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.
Leam Hall
2018-10-18 09:00:05 UTC
Permalink
Post by Karthikeyan A K
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…
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.



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

Continue reading on narkive:
Loading...