search

hjwp / Book-TDD-Web-Dev-Python

Book - TDD web dev with Python
https://www.obeythetestinggoat.com
Other
484 stars 175 forks source link

propose edits for tiny typographical/grammatical errors #230

Closed zipperer closed 5 months ago

hjwp commented 5 months ago

thanks very much indeed! how are you enjoying the book?

zipperer commented 5 months ago

I am enjoying it very much :)

Thank you for writing it and maintaining it.

General

The book has been easy to read and follow. It points to documentation, blogs, and essays -- each of which provides context for the ideas in the book and encourages the reader to explore further. And its conversational tone enlivens the prose.

Setting up development environment

I appreciate the care the book takes to help the reader set up an isolated virtual environment with python, django, git, and selenium -- each with its appropriate version.

Hosting content from the book

Hosting the book at obeythetestinggoat.com/book/CHAPTER with the Disqus forum for each chapter provides a convenient way for readers to share notes with each other and you. Hosting the source for the book on GitHub (a) shows readers a method to maintain documents over the web and (b) enables readers to propose edits and apply git skills the book conveys. And hosting versions of the repository against which a reader can diff his own (as described in this appendix) is handy.

Tests+commits serve as tools for focus+review

I am barely a novice in developing for the web and using web frameworks. So, I'm easily confused, and I'll need to review. The book uses tests and test failures to illustrate (a) the effects of each code change and (b) changes required to achieve a particular effect. This use of tests makes concrete the goal at each step in the book, and it leaves artifacts (tests and code changes bundled together in a git commit with a message) that the reader can review to remember how to add/edit behaviors.

Onward

I've read only 6 chapters. So my compliments extend only to that extent. When I've read 20 more chapters and a few appendices, I'll return and give the book a thorough lashing ;)

hjwp commented 5 months ago

lol thanks very much - really appreciate you taking the time to write up your thoughts. and the typo fixes too! let me know how you enjoy the next few chapters for sure!