2 ms·
Congrats on finishing your book! I know exactly how much work that can be. I hate to be picky but I know I'd want someone to point these out in my work, so I'l
by munificent 11y ago
Congrats on finishing your book! I know exactly how much work that can be.
I hate to be picky but I know I'd want someone to point these out in my work, so I'll hope you feel the same way. You have a few grammatical errors on your page:
"Building proper tests for a Magento extension can be difficult for seasoned veterans let's not say the junior developer just getting started with Magento."
You at least need a comma before "let's not say", but even then it still feels like a strange construction to me. Maybe "...veterans, not to say..."
"After all, you have written code like this a thousand times before; You know what you are doing right?"
Turn that semicolon into a period. I have a simple rule on when to use a semicolon:
Should I use a semicolon?
1. Nope.
2. There is no second answer.
"And yet, how much time of your day to day do you spend tracking and fixing bugs?"
If you really want to use "day to day", hyphenate it. But I would simplify it to "how much of your day do you spend...".
"What if you could do something that gave you confidence, not only on the quality of the code that is being promoted, confidence that if and when, someone has to make changes to the code there are tests that can confirm that nothing has been broken and the application still performs as expected."
There's some dead weight here and the clauses sort of run on. How about:
"What if you could do something that gave you confidence — not only on the quality of the code, but confidence that when someone changes the code, there are tests that confirm nothing has broken."
When I write, I do (at least) three drafts:
1. Get all the words down. Put all the clay on the table.
2. Rearrange and control structure and pacing. Push the clay into the right shape.
3. Edit every single sentence to tweak or remove words that don't add value. Trim the sculpture down to its final shape and texture.
My goal on the third draft isn't to strip it down to Hemingway. There's still room for character and charm to shine through. But it's to make sure that every ounce of prose adds some value, be it information, clarity, cadence, or humor.
- allanmacgregor 11y agoThank you! I love this kind of feedback. I'll sit tonight and play around with the landing page. A lot of the fun with this book has been finding a writing style that feels natural but is still clear enough; a bit difficult since I try to ramble. Cheers!