Analyzing top posts on my blog during 2015 — Deciding between brand versus readership
The main traffic on my site comes from new technical writers looking for general information about technical writing careers. To increase my readership, I would probably need to post more general information about technical writing (salaries, programs, skills, tools, etc.). But this kind of focus may take away from my brand or sense of expertise about more specialized topics. The topics you write about brand yourself as an expert in those topics, and ultimately you have to weigh what matters most to you.
My 2016 technical writing trends and predictions, or the ripple effects of API growth on technical writers
In 2016, the continued growth of APIs will create a ripple effect across the technical writing community that involves a variety of changes. Some of these changes include an increased adoption of Swagger, Markdown, revision control, learning programming, authentication solutions, Write the Docs meetups, new authoring tools, tutorials, API-based CMSs, and more.
Recording of Creating Documentation for Startups: Panel Discussion — Write the Docs San Francisco
The following is a recording of a panel discussion at a Write the Docs San Francisco meetup held Dec 17, 2015. The topic is on creating documentation for startups.
My upcoming 2016 STC Summit workshop and presentation
I'm going to be giving a workshop on API documentation and a presentation about Jekyll at the STC Summit in Anaheim, California in May.
How do you stay updated with changes developers are silently making?
You can stay updated with what developers are working on by analyzing the items assigned to the current sprint and asking the assigned developer for details.
Those pesky authoring tool questions, and an update on my adventures with Jekyll
At the last WTD meetup, someone wanted to know my current thoughts on using Jekyll. Is it still what I recommend? There are challenges with search, file directory fragmentation, and authentication, but only the first point is inherent with static site generators.
Recording of Version Control, Writers, and Worfklows by Richard Mateosian
You can watch the recording of Richard Mateosian's November 2015 presentation to the STC Silicon Valley about version control, writers, and workflows.
Question: How long does it take to ramp up on your Jekyll theme?
Using Jekyll for documentation will probably require more time and effort than a commercial out-of-the-box authoring tool. On the other hand, Jekyll may be more suitable to you if you're customizing a doc website, want a developer's workflow, or simply want the freedom of using open source tools and working in code.
Swagger UI probably the coolest thing I've done in API docs
Swagger should be a feature of every REST API doc set, since it connects with the user's primary desire to try out a product in order to learn it.
10 realizations as I was creating my Swagger spec and Swagger UI
As I've been configuring the Swagger spec file and UI for one of the APIs I document, I had a few realizations that I wanted to share. Some realizations involve understanding the Model versus Model Schema part of the Swagger UI, the syntax of using JSON references within the spec, how validation works, and more.
Guest Post: Could Software Perform Technical Writing? by Robert Desprez
In this guest post, Robert Desprez looks at the possibility that advanced technology may replace the need for technical writers. Desprez explores a recent book by Martin Ford (Rise of the Robots) on the subject.
Single sourcing the Swagger spec and main documentation using Jekyll
You can use Jekyll to populate variables in both your Swagger spec and main documentation. This allows you to single source your content into both of these outputs in a more efficient way.
Version 4.0 released for the Jekyll Documentation Theme
Version 4.0 of the Jekyll Documentation Theme now supports multiple projects inside the same theme. This allows you to use the theme for any number of documentation projects with any number of authors.
Planning my API doc course
As I prepare to record my API doc course, I'm finalizing a few thoughts about the content, setup, and other details.
Upcoming Write the Docs Meetup
subscribe via RSS