---
title: "My top 3 posts of 2016 are all Swagger-related – lessons learned from 2016 analytics"
date: 2017-01-17
description: "Page views and session metrics Top pages Reasons for increase in traffic The larger trend is documentation Page..."
canonical_url: https://idratherbewriting.com/2017/01/17/trends-2017-swagger-all-the-way/index.html
---

> For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

# My top 3 posts of 2016 are all Swagger-related – lessons learned from 2016 analytics

> This past year the stats on my blog showed some surprising results. From about mid-2016 on through the present, there was a notably upward trend in page views. I attribute the upward trend primarily to some posts on Swagger. The larger trend is that all top posts on my site could be classified as documentation content.

## Page views and session metrics

Here are a couple of screenshots from Google Analytics:

![The blue line is 2016, the brown is 2015. Page views were 778k for the year, up 24% from 626k the previous year. That's an average of 2k+ page views each day.](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/trends2017.png)

![Sessions were up 31% for the year, to 497k from 377k the previous year. A session is a single visitor's time on the site, not counting the number of pages the user visits.](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/sessions2017.png)

## Top pages

What pages were users visiting? Here are the top 10:

![Users were looking for information on Swagger!](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/2017toppages.png)

Here are links to pages listed in the above screenshot:

- [Swagger tutorial](https://idratherbewriting.com/learnapidoc/pubapis_swagger.html)
- [10 realizations as I was creating my Swagger spec and Swagger UI](https://idratherbewriting.com/2015/12/10/ten-realizations-using-swagger-and-swagger-ui/)
- [Swagger tutorial link](https://idratherbewriting.com/2015/09/14/swagger-tutorial/)
- [Quick reference guides](https://idratherbewriting.com/quickreferenceguides/)
- [Technical Writing Careers – Answering 13 Questions about Technical Writing Jobs](https://idratherbewriting.com/2008/02/16/technical-writing-careers-answering-13-questions-about-technical-writing-jobs/)
- [Quick reference guides: Short and sweet documentation](https://idratherbewriting.com/2009/04/10/quick-reference-guides-short-and-sweet-documentation/)
- [Documenting REST APIs](https://idratherbewriting.com/learnapidoc/)
- [Javascript Event Listeners](https://idratherbewriting.com/events-and-listeners-javascript/)
- [Are Certificate Programs Helpful for Transitioning into Technical Writing?](https://idratherbewriting.com/2011/01/06/certificate-programs-helpful-when-transitioning-into-technical-writing-collaborative-post/)

## Reasons for increase in traffic

Some of the top pages can be explained away as flukes. I doubt people are searching for “quick reference guides” and trying to learn how to create these formats for documentation. They’re probably looking for a quick reference guide for their device and are just typing in “quick reference guide” generally into Google.

Posts about technical writing careers and certificate programs are perennial favorites. A lot of users (hello English majors!) are looking for tech writing information online and searching for career advice.

The JavaScript article is one of those weird instances where a single post shoots to the top based on unpredictable factors (the melting ice caps?).

But the BIG NEWS is that the top 3 posts are all related to Swagger. In fact, that [Swagger tutorial](https://idratherbewriting.com/learnapidoc/pubapis_swagger.html) is driving a steady stream of visitors to my site. That article brought 104,000 page views in 2016, which is more views than my homepage (the “/”) gets.

If you search for “Swagger tutorial,” my page is in the top 3 results. I find this odd, because it’s not even a very good tutorial.

This tells me several things:

- The [documentation for Swagger](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md) is really bad, so people are looking elsewhere for information.
- Swagger is a hot trend that people are hungry for information about.
- I should probably fine tune the heck out of that page.
- People searching on the web often include “tutorial” in what they’re searching for, especially when the official docs are confusing.

> **Tip:**If you want a tip for a book topic, try writing a user guide for Swagger that reads like friendly documentation rather than a spec!

## The larger trend is documentation

Finally, let’s look at a fundamental trend about all of my top posts. Are they clever examples of storytelling? Are they personal narratives? Are they comedic monologues? Videos? Existential laments? Political rants? Probing interviews? Nope. They are all **documentation**.

Yes, the top posts on my site are all information-rich posts offering tutorials, instruction, or other guidance. This is what people search for on the web. It’s exactly the kind of content we produce on a daily basis as technical writers. We’re fueling the web with information people want.