7 ms·
Communicating in writing is THE core skill for a systems architect, just like drawings are the core skill for construction architects. Review, carefully, stuff
by OliverJones 6y ago
Communicating in writing is THE core skill for a systems architect, just like drawings are the core skill for construction architects.
Review, carefully, stuff written by other people on your team. Do it promptly, and avoid developing a backlog of stuff to review.
Work on writing clearly. It's like coding; you can improve your writing by reading good writers (and bad ones). Becoming a good writer takes a lifetime.
Don't use the passive voice unless you must. It almost always reflects sloppy thinking.
Always answer the question "why?" in your written work.
If you can help from a technical editor, use it. Pretty much all writers except university students have editors.
To go all Yoda on you, in a job like yours "the only way you can do enough is by doing nothing." Avoid getting bogged down if you can.