The early release of my ebook Juggling JSON with jq comes out tomorrow! However this post is more about the process of writing the book itself.
Getting started on an technical ebook, (such as Juggling JSON with jq), requires a bit of upfront setup. On the ebook side, I decided to go the route of writing the book in Markdown, and generating the various formats using Sphinx. While I feel most comfortable using Markdown, and yet Sphinx uses reStructedText by default. So I had to coax Sphinx to accept Markdown by using a project called m2r. Generating the PDF version of the ebook took a bit to get working. Sphinx uses LaTeX to generate PDFs, and LaTeX while powerful can be clunky to work with. I wrapped everything up with an invoke script, and now I can quickly generating new versions of ebook in the various formats I want to support.
Something unique to writing technical books, is the need to have actual working examples. You can learn by reading, but working through exercises and examples re-enforces that learning. In the case of Unjumbling JSON with jq, I needed an example REST API that readers play with. I searched for some nice open APIs, but nothing seemed very compelling. Many of the open APIs require some form of user registration and non-trivial authentication method that would complicate the examples in the book. So I setup a simple demo API for the book. Thankfully with Docker and Flask, that isn’t a particularly daunting task. (Dockerizing most of my webapps definitely made my live easier overall.)
As mentioned in a previous post, I originally planned on writing a single book on both jq and httpie. I divided the original book in two, because there is only a small overlap between the two. I wanted to show examples of grabbing a REST API response via httpie, and parsing the JSON output with jq. However basic querying a REST API is something that could be covered in a short section. By writing the books separately, I will be able to release them faster, and the books will be much more focused.
I plan on selling early drafts of the ebook on August 10th. Buyers of the ebook will get regular versions of the evolving drafts of the ebook, and a free upgrade to the final version of the book. I want to release the early drafts to get early reader feedback. In addition readers of the book will have access to the REST API that accompanies the book.
Or rather I am back. As in I am going back to blogging. I apologize for the months of silence. Moving houses, and migrating web hosting providers will do that to a person. Migrating the web hosting to a completely self-managed environment was quite a learning process, and took quite a bit of time. I did not realize at the time, that my websites would be down for months. Fortunately everything is back to normal now.
I won’t commit to posting on a regular schedule, since that is simply not realistic. However I missed quite a few excellent opportunities to blog in a timely manner. Especially everything surrounding PyCon and all the new things I’ve learned since that time. I will try to make that up by writing articles about events, knowledge and ideas.
I was really surprised, since I had left that blog and closed down account years ago. I started that blog when still in university and before I could afford my own fancy WordPress installation. Years later after moving my old content and closing down that site, I find a new post. At first I wondered if someone had hacked into my account and started doing weird things. However this would be not the case.
You may have noticed the recent changes on my blog & portfolio website. I am in the process of migrating my websites, domains and what not to a new hosting service. A nicer hosting service provider who doesn’t support SOPA/PIPA for one. Plus is much more responsive and nicer to work with.
Anyways a lot of things are up in the air. Especially since I am still transitioning in terms of my new work. Plus I am working on a grey op (not quite black) project, that I plan to reveal shortly. Please excuse the sporadic changes and some issues might pop up while I get everything sorted out.
The madness of the past few weeks, has taught me the importance of quiet time. Time that I can truly reflect quietly and calmly work on the next steps I need to take. Most of the week I have rushed, ran and tired to compact as much I could into a single day. But you can only do this for so long before you have to slow down. While life fills up with small, urgent tasks, those tasks are rarely that important. Not to say I can forget about the small tasks and go on living comfortably. Those small tasks after all act as the components of the large important projects in life. Yet three ideas that have helped me recently are: 1) to keep the important projects in the front of my mind; 2) remember the scale of importance between the day-to-day tasks and the goals in life; 3) maintain balance in one’s life.
Anyways, enough philosophizing for one post…
While I was riding on the train back today, I tried to catch up on some e-mails. And I found out about the new version of WordPress was available for my sites. Thanks GoDaddy for being an awesome web host and sending out e-mails notifications of those kind. Anyways after some twiddling with the new WordPress update, I decided to do some house-cleaning of my website. One of the slight modifications I made is the new title of the blog. Yes, I am back to using “The Art of Being Dorian”. This has been the best title so far, and while thought about using the geeky “Transmissions from High-Earth Orbit” or obscure “Mlaren Racer” or the nice but misleading “The Zen of Dorian”. (Misleading because even though I like Zen as a design methodology or as a general idea of simplicity, I am not a Buddhist nor do I follow Buddhist philosophy, culture, etc.) Plus, I good friend of mine in Ireland loved this name back in the day. And so it is back.
Also note that I dropped the “Hacker, Gamer, Writer” moniker. Hacker, yes if it means coder and not cracker as it means in conventional terms. And while I still enjoy playing the occasional game, I rarely do so. So by definition I fall out of the “gamer” crowd. Just like I’m not much of a boarder since I rarely have the chance to go snowboard, surfing or windsurfing.
So this blog I will dedicate to writing articles about coding, writing and living well. I think it will be most benefit for everyone. And I will enjoy sharing my knowledge in these fields, more so than the random ranting that I’ve done in the past. I hope you enjoy the new blog!
Outside the window, grey clouds fill the sky and raindrops stream through the air. A warm morning for an early December day, the weather being more likely for mid-November. The rain does not bother me as I am sitting in a GO train headed to downtown Toronto, and getting ready for the start of a new day.
Since I started working at Indusblue as an Android developer, my mornings involve a morning train commute to Toronto. While taking the train and streetcar to work extends my commuting time, I can not complain. I get about two hours each day of time for myself, to get work done. Amongst other things, I use this time to write or catch up on past work. Today I decided that instead of sleeping on may to work, I would update this blog.
After a summer of travelling to and from San Francisco and spending a good portion of my Fall travelling in central Europe: Poland, Germany, Austria and Italy; I finally am settling down at the end of the year. While I love travelling and visiting new places, I am glad that I have returned to Toronto. I am glad to be close to most of my friends, family and familiar settings.
Since my return, I have concentrated on catching up on overdue work. So many tasks and delayed projects have piled up, that I feel the need to make progress on them or even finish them before the end of the year. Amongst other things I started writing two pieces: a science fiction novel and an auto-biography of sorts. Also I started working on justcheckers again, which I plan to complete as part of my portfolio work. And I am working on a few other missing or lacking parts of life, that I can not comment on right now. However I am overjoyed with the progress I have made, and the opportunities that linger on the horizon.
So while the mornings are grey and rainy and sometimes quite cold, I am grateful for the new reality of life I am in now. It might rain outside, but I feel as if it were sunny.
Life, nature or the universe has a perverse sense of humour. The next day after I posted my last blog post, optimistic of the future and looking forward to approaching life in a slower pace… well everything happens at once. And it seems like someone decided to fall asleep on the ‘drama’ button in my life. So now things are exciting, moving quickly and require immediate and decisive action. I am not amused, by this turn of events.
Since this seems like a prevailing theme and trend recently, I’ve had to make decisions to simplify my life. I have to minimize the distractions and maximize the impact my action have on my surroundings. If that does not happen, I will simply get swept away and get carried off by the next big wave.
Today I realized I need to take my tasks and projects head on. That means do the most relevant, NOW. It also means putting up a single list of to-dos and sticking to them. And I have to simplify life and remove distractions. One such distraction is maintaining my blog. I love blog, I love writing and publish my thoughts. But I do not like having to administer it. Hence I migrated to WordPress a long time ago.
And also why I am turning off comments on my articles. I am sorry to my readers, but the majority of you don’t comment on my blogs. I don’t mind that. Most of my articles and journals are not something one can or need to comment on. And the majority of comments that get queued up are spam. Even with Akismet running in the background, I get too much crap. These days I have precious little time to blog or do anything outside of the urgent. And I definitely do not have time to read 200+ comments all trying to commit various forms of link spam. I want to use my precious time for blogging and updating my sites. So no more open comments on my blog. Some articles I will open for comments, but most will not. Sorry but it is just something I need to do.
So I am back in California again at the request of my client. Fortunately for not as long as last time. While Northern California is a great place to live in, it is not quite the palm lined, sunny, warm dream that Hollywood and LA make it out to be. Summer in the San Francisco Bay Area is much like Toronto’s late spring. But not comes close to the humid summers of the East Coast. Plus living in a hotel in a suburb away from everything including friends and family is not fun.
The one good thing is that I have time to reflect, and to catch up. One such thing being blogging and writing for me. I do miss writing and hopefully once I clear off my immediate urgent work, I can do more writing. With any luck there will be more updates to this blog. And even better… more chances of writing long-form prose. However I have to first write back to all those e-mails sitting in my inbox, screaming for attention.
Work occupies most of my waking hours. I wish I could talk about my work in greater detail, however my client wishes to keep a lid on the project I am involved in. I do not blame them, as the final product will be a great surprise to their customers. And a wake-up call to their competitors. I can not say more than this: working on an embedded Linux tablet project is fun. As a developer I love a good challenge and this project presents many such challenges. And I am inspired to continue down this career path.
Life continues to swirl randomly and unpredictably around me. Lots of good signs keep me motivated to try harder. Still the challenges continue on mounting and sometimes the sheer volume is overwhelming. However I am still hopeful that this is the mere “storming and forming” before life takes on a certain elegant pattern and routine. I wish I could say more, but I fear that I might jinx things I reveal too much, too soon…
Wow. I hoped for a less ambiguous post. Still it can not be helped, given all the circumstances.