Featured image of post Mastodon - 2023-08-21

Mastodon - 2023-08-21

Toots from 2023-08-21

Hot leadership take: using evaluative language in level descriptions (“good” documentation, “pers…

Hot leadership take: using evaluative language in level descriptions (“good” documentation, “persuasive” slide deck) is more effective when paired with a concrete example that can be deconstructed together.

What makes the documentation good? What makes the communication persuasive?

General guidelines are helpful & those should be illustrated with an actual example from inside the organization. The exemplar will change over time, but should be anchored in stable principles.

Mastodon Source 🐘

“Write it better” isn’t constructive.

“I’d suggest adding sections to address X, Y, and Z…Take a look at this other artifact for ideas on how to present that information” is more helpful.

If there is no example, then that’s probably a signal to create one so that the evaluative language can be calibrated.

Mastodon Source 🐘

More sad news this weekend..One of the pioneers: <https://www.theverge.com/2023/8/20/23839212/ado…

More sad news this weekend..One of the pioneers: https://www.theverge.com/2023/8/20/23839212/adobe-co-founder-dr-john-warnock-has-died-he-was-82

Mastodon Source 🐘