Hacker News Reader

Comment by krever | Hacker News Reader

Hey, author here :)

Its at least 80% organic artisanal writing and maybe 20% AI when I needed help with grammar, completeness, broader perspective and everything around.

View on HN

It may be a good idea to start the book with a really short "About the author" to state exactly this and your work experience. Otherwise looks well written to me, good job! :)

Native English speaker. I scanned it and IMO there's a slight overuse/misuse of hyphens. Maybe the AI tool could be asked to identify and correct? (The hyphens might be triggering people to think it's AI, too).

They mostly need replacing with a full stop or a colon.

E.g.

"In practice this means storing the amount as an integer in its smallest unit - €12.34 becomes 1234"

"In practice, this means storing the amount as an integer in its smallest unit: €12.34 becomes 1234."

"In practice, this means storing the amount as an integer in its smallest unit (e.g., €12.34 becomes 1234)"

Hyphens here are meant to be formatting. You would be correct if this was a literary piece, but handbooks and sheets don't need to use these rules.

It's a misuse because in this context the hyphen could be mis-construed as a negative amount, and this causes the reader to stop and carefully re-read the content to ensure that they're not misinterpreting it. That's not where you want to be spending your reader's attention.

Spelling, grammar and punctuation matter everywhere, in my opinion.

I wouldn't have read your comment if it were all lowercase and used zero punctuation, for example.

Reply on news.ycombinator.com