News for hackers. Stuff that matters.

A comment on Ask HN: I've been promoted to Architect. What do I need to learn/do to excel?. Parent comment

Re:Ask HN: I've been promoted to Architect. What do I need t... by jefftk on Tuesday May 12, 2020 @11:09AM (#23154803)
Things I've found useful:

* Use a platform where it's very easy for people to give feedback. I've used Google Docs and Quip.

* Write documents when there's real disagreement about how something should work.

* Ask specific people for feedback on your documents.

* Ask other people to write things, read what they write, and leave good comments.

* Have a regularly scheduled meeting for reviewing team documents to get feedback. Anyone can sign up with a doc they want reviewed.

[ Parent | on HN ]
Re:Ask HN: I've been promoted to Architect. What do I need t... by edraferi on Tuesday May 12, 2020 @02:01PM (#23157345)
Also:

* Write clearly & concisely

* Use good headers and provide a table of contents

Here are some useful resources for writing better:

https://www.plainlanguage.gov/

http://www.hemingwayapp.com/

[ Parent | on HN ]