@hiskennyness the docs took about 25 times longer.

There's only about 600 lines of clojurescript.

I am in deep trouble. 🙂

But ... it was deliberate ... i was learning as I was writing

It all depends on how much thinking you have to do

When I wrote re-frame, I was new to reactive programming, and functional programming and Clojure and everything. So the writing exercise was pretty much me explaining it all to myself

There was a feedback loop.

the more re-frame i write the more sour i become to other ways of doing UIs. everything else just feels just so icky, so your efforts are much appreciated

code <-> design <-> docs There's a good reason universities make their professors also teach. There something about the process of having to explain yourself that sharpens your understanding hugely.

Even if you never show anyone the docs :-)

@hiskennyness I'm a slow writer. You will be faster. Lucky you. I suffered.

First trick is this ... don't, whatever you do, try to make your docs too good. Give yourself permission to do a shabby job. Really shabby. Take the pressure off. Bullet points.

Ugh. My problem is writing too much. You did great, by the way. Clear and fun prose.

My first drafts were utter rubbish. I assure you 100%.

And thank you.

@hiskennyness if your write too much, only allow yourself to write bullet points. Constrain yourself.

Use small words and short sentences. Resist the urge to be clever or to write in a way that screams to the reader "Look, I'm smart".

(These are all my flaws)

Anyway, stick with it.

You will be a clever person at the end of it

I am going to read some Hemingway to get in shape for this. Thanks for the pro tips.

Haha, I wrote that before seeing your “short sentences” remar!

@hiskennyness "Style. Towards clarity and grace". by Joseph M Williams. That book changed my life.

(about 20 years ago)

I experienced that book like a nuclear bomb going off in the back on my brain. It was similar to "drawing on the right side of the brain". Suddenly, something hitherto impossible became a bit difficult but doable.

You just reminded me of Strunk & White, the Elements of Style.

Can I get my kids to read either book? No. :-)

Hello there, this is an humble request for a code / architecture review 🙂 I’ve recently been tinkering with this small pet project: https://github.com/piotr-yuxuan/choose-a-new-phone I’m wondering what you think about the general architecture, and why you would have done differently.

Any remarks from you guys here would be really invaluable, and I would take great care in considering it!

Another thing I’ve borrowed from Hemingway is to stop what I’m doing as soon as I know what to do :-)