Live data from Hacker News

Show HN: I wrote a book about Go

practical-go-lessons.com

131–140 of 160 posts

Re: Show HN: I wrote a book about Go

#132

Hello all, After 2.5 years of writing, countless weekends and evenings, I released a book about the Go programming language. The book is available for free on the website because I wanted to give something back to the developer's community :) It is composed of 700+ pages, 41 chapters, and approximately 405 drawings/screenshots. I tried to cover all the important topics that a new Go programmer should know. At the end…

I think this is very well structured. I really like the "Test yourself" section. As a person who finds small post-reading assignments enjoyable and motivating, my only suggestion would be to add a small assignment that employs the learnings. Actually coding what one just learned is arguably a good way to reinforce the learnings and raising further questions/doubts. E.g. for your Application Configuration chapter, an example assignment could be:

    Create a command line application that accepts users inputs as below:

        a. Mandatory "-firstName" flag to accept first name
        b. Mandatory "-lastName" flag to accept last name
        c. Optional "-middleName" flag to accept middle name
        d. Mandatory "-age" flag to accept age - only integers between 0 and 200 should be accepted
        e. Optional "-party" flag to accept political party following - only valid values are "D", "R" and "I"
        d. Optional "-userId" flag to specify user id - if HOME environment variable is set, extract user id from home directory path

Re: Show HN: I wrote a book about Go

#133
post #109

Earlier quoted context omitted.

MkDocs isn't a "format" as such. It requires you to write Markdown and then configure the mkdocs.yml file to define the website's properties, such as the navigational structure.

Thanks for this clarification I will check this.

We’ve been moving some docs meant for other teams to mkdocs from Confluence at work and I’ve been happy with it - GitBook is also popular.

Re: Show HN: I wrote a book about Go

#136
Really impressive. I'm a full time Go coder now, and lately I feel that a lot mediocre tutorials are appearing. In the sense that they compare as fast food to a quality dinner. I skimmed through your book and found the things I wanted to see: how to test, error wrapping, proper use of interfaces, etc. Your book is quality food. Excellent job!

Re: Show HN: I wrote a book about Go

#137

Hello all, After 2.5 years of writing, countless weekends and evenings, I released a book about the Go programming language. The book is available for free on the website because I wanted to give something back to the developer's community :) It is composed of 700+ pages, 41 chapters, and approximately 405 drawings/screenshots. I tried to cover all the important topics that a new Go programmer should know. At the end…

Would you consider open sourcing the book? What systems are you using to create and maintain it?

Re: Show HN: I wrote a book about Go

#140
post #137

Hello all, After 2.5 years of writing, countless weekends and evenings, I released a book about the Go programming language. The book is available for free on the website because I wanted to give something back to the developer's community :) It is composed of 700+ pages, 41 chapters, and approximately 405 drawings/screenshots. I tried to cover all the important topics that a new Go programmer should know. At the end…

Would you consider open sourcing the book? What systems are you using to create and maintain it?

Hello rijoja, I'm currently thinking about it.

I'm writing the book with Lyx. Lyx documents are converted to LaTeX docs, then converted to HTML with pandoc. Then I have a homemade Go script that generates the VueJs components (one per chapter).

This question is asked a lot so I will write something about the system because it can help other writers.

Post reply on HN