Suppose I decide to go full speed ahead with technical writing. Where do I go from here? If I do decide to stay in this field, I'd probably get involved with some open-source documentation projects (to build a portfolio, since the stuff I'm writing now is owned by my company), create a...

text editors, writing in plain text, processing pull requests instead of bugs, and more. He dives into lightweight markup syntax, static site generators, version control tools, and more, as well as challenges he has faced. Here's a description of the presentation: In Modern Technical...

I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and...

argues that writers should spend most of their time researching and testing content, investigating analytics, and iterating on the doc content on their websites. With regards to documentation formats, Etter writes: ... one of the tenets of modern technical writing is that everyone is a...

Every so often someone asks me if they should get a graduate degree in technical writing. Penelope Trunk has a controversial post in which she argues that graduate degrees aren't necessarily smart business decisions. Graduate schools can be an environment that removes you from the world of...

Any good ideas? I realize that I sometimes come across as zealous about technical writing. This is how I've branded my online persona. And sure enough, although I don't participate in Zumba, after reading the tweet I couldn't help but consider the possible parallels between tech comm and...

which is what I'm calling it) works particularly well for developer documentation, such as API documentation, which usually doesn't contain the same challenges that component content management systems (or CCMSs) were meant to solve. The number of comments on my recent post, Review of Andrew...

But mostly you have the same potential to write and publish content. With technical writing, I'd like to see help authoring companies move towards similar models: offer a freely hosted solution in the cloud, but also offer a self-installation solution. Let users choose. Now here's the...

On a recent trip to Claire's with my three girls, I saw a sign that captured the distinction between marketing writing and technical writing perfectly. I love communicating information in a clear, easy-to-understand way, which is why I become a technical writer. Prior to working as a...

The constant trend in technical writing seems to be for someone to preach about a new solution, write and sell books about the solution, and then sell their monster software solution to companies willing to invest all their time, money, and resources in it.....even though it doesn't solve...

 

Related shopping