Search results

My Calm Meditation app -- another experiment to test my docs

by Tom Johnson on Apr 27, 2017
categories: api-doc technical-writing

I recently created an HTML5 web app called Calm Meditation. If you have a Fire TV, you can check out the app by searching for it in the Amazon Appstore. I'm not really into meditation, but I needed some sample video content to test out a web app framework I'm documenting. The idea I came up with for generic video content involved nature still scenes with some background music. I think it worked out okay, actually. There's a whole genre of these types of apps, apparently.

You can view my Calm Meditation app in the Amazon Appstore here.

On your Fire TV, search for “Calm Meditation.” (The app doesn’t work on Kindle tablets.)

My primary role at Amazon involves creating documentation for third-party developers creating Fire TV apps. Previously, I wrote about how I created an Android app from the Write the Docs podcasts. HTML5 web apps differ from Android apps in that they use web technologies (HTML5, JS, CSS) instead of Java and Android APIs. I didn’t want to have two different apps with the same content, so I set about to capturing some generic video content last weekend to build the web app.

With my 6-year-old riding beside me on her bike, we ventured down the San Tomas Aquinas trail with an iPhone and tripod in hand, periodically capturing 2-minute still scenes from the trail and accompanying canal. I then uploaded the videos to YouTube and chose some Ambient background music. I also grabbed some interesting Buddha quotes to use in the descriptions.

The result? Some quasi-meditational videos that look decent enough to be a real app. My kids love it (anything that appears on the TV screen gets their attention). My six-year-old said we should call it “The Calm App.” When you’re stressed out, you go and watch a few videos while focusing on some slowly moving element (e.g, blades of grass, ripples in water, passing cars) to focus your attention on nothingness. It kind of works. I’m not into meditation myself, as I don’t have the patience for it (sadly), nor yoga. But I had a lot of fun creating this app!

I also created a companion site that contains the videos: idratherbewriting.com/calm-meditation. I created the site to generate an MRSS feed, which is one way to configure the media in the app framework. The web site uses the generic Jekyll theme (Minima) and is hosted on GitHub. (If you need an MRSS template, check out the feed.xml file in the source. Jekyll is awesome for creating feeds like this.)

Creating the videos was a fun activity for both me and my daughter. But the real reward came in trying to configure a new app framework (release date coming soon) using my video content. The dev team thought a short FAQ was pretty much all that was needed. Well, as you can probably guess, as I was going through the “simple” app that was so easy to use, it wouldn’t require hardly any documentation, I had about 30 questions and identified several significant problems. I wouldn’t have this insight without actually going through the same process as developers would, using actual content.

The most important activity in creating documentation is to run through the tasks you’re instructing your user to do. It’s only then that you can truly evaluate the information accuracy and needs.

For more details on testing your app, see the following sections in my API doc course:

Creating this kind of video content was easy, so I may create more “meditation” apps in the future. Who knows, I may even start using them to meditate.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.