Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Show HN: I wrote a modern Command Line Handbook

commandline.stribny.name

Post reply on HN
Print view View original

71–80 of 115 posts

Re: Show HN: I wrote a modern Command Line Handbook

#72

Post by 0x62 »

The content seems really great, however the typesetting makes it quite hard to read:

* Code blocks on a subsequent page to the explanation, especially when there is enough space to show it (p18/19)

* Call-outs as above (p26/27)

* Single words broken by a page (p51/52)

* Footers spanning multiple pages (p61/62)

It sounds quite nitpickey but I find it really breaks the flow when I’m reading, and trying to comprehend a section requires scrolling back and forth between two pages.

Re: Show HN: I wrote a modern Command Line Handbook

#73

Post by petr25102018 »

0x62 wrote: post #72

The content seems really great, however the typesetting makes it quite hard to read: * Code blocks on a subsequent page to the explanation, especially when there is enough space to show it (p18/19) * Call-outs as above (p26/27) * Single words broken by a page (p51/52) * Footers spanning multiple pages (p61/62) It sounds quite nitpickey but I find it really breaks the flow when I’m reading, and trying to comprehend a…

Thanks for the feedback.

I agree and I try to keep it as nice as I can, but it can be hard to do when the book is being updated and the content changes.

Nevertheless I will be mindful of it for the next update.

Re: Show HN: I wrote a modern Command Line Handbook

#74

Post by petr25102018 »

rubit_xxx17 wrote: post #68
petr25102018 wrote: post #9

Earlier quoted context omitted.

True, the landing page could be more detailed. I didn't want to repeat much the info on Gumroad page, but maybe I should rethink it. And thanks for the copy suggestions. I am not a native speaker :)

I’m excited about this book and appreciate your work! One thing that was distracting was the large title font when I tried to view this site in portrait mode on mobile, as some of the letters are cut off. If that could be fixed, it would help ensure people stay engaged and read it. You could also potentially use an LLM or something like Grammarly to help proofread it (not edit it). This is very cool!

Thank you!

Yes, as other people pointed out too, the landing page could do with some mobile and copy improvements.

Re: Show HN: I wrote a modern Command Line Handbook

#75

Post by JulianWasTaken »

petr25102018 wrote: post #61
JulianWasTaken wrote: post #32

Looks very nice! I have an interactive tutorial I wrote and teach with which is here: https://github.com/JulianEducation/CommandLineBasics in case it's useful as well. I only have 90 minutes in my case so it's a constant battle to tweak what I can get to with my audience, so there's still lots of things I want to change. But I think it's very important to have lots of resources here so I'm excited to look at yours.

Thanks. You teach this in a classroom?

I do, it's given as a seminar twice a year.

Re: Show HN: I wrote a modern Command Line Handbook

#77

Post by petr25102018 »

JulianWasTaken wrote: post #75
petr25102018 wrote: post #61

Earlier quoted context omitted.

Thanks. You teach this in a classroom?

I do, it's given as a seminar twice a year.

Nice! At least you get your feedback in real time, see what people struggle with and so on. That can be very useful.

Re: Show HN: I wrote a modern Command Line Handbook

#79

Post by petr25102018 »

sagarpatil wrote: post #78

Just bought it. Any advice on how to use the book to master the terminal? One page a day or try to finish everything in a week or two?

I definitely recommend to try things as you go along, copy paste things and run them yourself. As for the timeline, everyone is different. My own take is that learning always takes time and repetition, so I would not rush it and focus on practice.

Re: Show HN: I wrote a modern Command Line Handbook

#80

Post by curtgrimes »

petr25102018 wrote: post #58
jaredhallen wrote: post #49

Earlier quoted context omitted.

I am also seeing text off the screen using Brave on Android.

You are right. It is wrong, will need to look into this.

These two tweaks should improve it (by preventing the largest text and book graphic from overflowing the viewport horizontally on some smaller screen sizes):

  diff --git a/index.html b/index.html
  index a0f978c..040e50e 100644
  --- a/index.html
  +++ b/index.html
  @@ -21,3 +21,3 @@
         h1 {
  -        font-size: 3.8em;
  +        font-size: clamp(2.2em, 7vw, 3.8em);
           margin-bottom: 0;
  @@ -60,2 +60,3 @@
         .hero-img {
  +        max-width: 100%;
           transform: rotate(2deg);
Also, I really like what I see in your book so far and I am already learning things on the first few pages. Thanks!
Post reply on HN