Skip to main content

Technical Blogging session at ElaConf 2016

This is probably going to be one of several blog posts related to ElaConf. It's a wonderful conference for empowering women in tech that took place in Philly for the second time recently. One of the breakout sessions at ElaConf was on Technical Blogging which was run by Vaidehi Joshi (@vaidehijoshi). Here are my takeaways from that session.


We started off by reading Julia Evans' blog post on processes. Vaidehi asked us to take a few minutes to read it and discuss with a partner. Here are some things that stood out to us in the blog post:

  • Conversational
  • Matter of fact
  • Formatted Code snippets
  • Author's personality shows in the code comments
  • Condensed scope, author links to external content for more research
  • Good introduction to the topic even for a newbie

We also took some time doing a fun exercise, with one of us pretending to be a student and the other a teacher. The teacher had to describe "opening a Facebook account to someone who has not used a computer before". This was fun. As a student, I pretended to not know what a computer or Facebook was which made it harder for my partner to describe the solution.

The point of both the exercises was to figure out how to teach others a new technical concept effectively. This is where storytelling comes in. An effective technical blog post hooks the reader by getting them invested in the problem and then interested in how a solution was figured out.




So where do you get started with technical blogging?

  • Start with things you want to learn
  • Things that you've already learned
  • Side Projects
  • Features you built or designed
  • What's new in technology
  • Weird bugs and how you solved them



How do you make it a habit?


Vaidehi suggests coming up with a goal. Her goal was to blog once a week every year. She picked Tuesday as her day to blog and called it Technical Tuesdays so that she produced a blog post every week on that day.



Wait, why should you blog?


For various reasons. A lot of times, documentation is lacking in tech. Blogging helps you communicate your ideas, helps you grow as a programmer and makes you a better teacher. It is also an awesome resume and has a great impact on your career. It does not matter who is reading as long as you write for yourself. People will stumble upon it when searching for something and might find the solution they are looking for, and could end up reaching out to you with questions.

Looking forward to writing more technical posts!

Slides from Vaidehi's breakout session are available here.


Comments

Popular posts from this blog

Recap of Android Summit 2017

I recently attended and spoke at Android Summit , an Android conference organized by the folks at Capital One. Special shoutout to Jared A Sheehan, Michael Jones and the entire organizing committee for running a fabulous event which raised $6000 for Women who Code. All speakers received a Phillips Hue Starter Kit as a speaker gift which I've used to toggle and dim my living room lights via Amazon Echo. So much fun! I had a prior commitment and could only attend Day 1 but here are my highlights. Process & Workflow A common theme on Day 1 was process and workflow talks which tied in beautifully with Kelly Shuster 's keynote. Kelly is an excellent story teller. In her keynote, she connected a story of communication from her theatre background to how developers, designers and testers need to work together to reduce boiler plate conversations when designing and developing apps. I gave a similar talk earlier this year at  Chicago Roboto  with my co-worker and designer  J

Chicago Roboto 2018 Recap + First Keynote!

Chicago Roboto was back again this year as a single track conference and there were a lot of excellent talks.  Last year I gave a talk with my co-worker and product designer extraordinaire Jess Moon about design and development workflows and this year I was back again but as a Keynote speaker. Keynote Giving a keynote was a stretch goal I set for myself in 2018 and I managed to achieve it early thanks to the Chicago Roboto review committee. The topic I chose was being an Android Advocate who brings teams and communities together. I will be writing a follow up blog post about my keynote process soon but before that, a quick shout out to Corey Latislaw and my coworkers at Warner Bros. Digital Labs who took a look at my first and second drafts and listened to all my half-baked thoughts and ideas. Achievement unlocked 🎉🎉🎉 - Gave my first keynote @chicagoroboto #chicagoroboto Slides with resources available at https://t.co/OJVbZa3Akj — Yash Prabhu (@yashvprabhu)

How I prepared for my first big conference talk

Last Friday, I gave a talk at AnDevCon Boston. I had about 4 months to prepare since the conference's C all for Proposal(CFP) deadline was in March and the conference was in July. "Monetize Apps on the Play Store: Integrating in-app Billing in Your #Android App w/ @yashvprabhu at #AnDevCon http://t.co/Pw1ZKy5Fek — AnDevCon (@AnDevCon) June 30, 2015 I have broken down my entire process of giving a presentation - from writing an abstract to giving the final talk into the following steps: Choosing a conference and submitting a proposal Breaking down the topic into smaller components Giving my talk at a local meetup Prepping for the conference Prepping hours before the talk Choosing a conference and submitting a proposal The whole process of giving a talk started at the Write/Speak/Code conference which happened earlier this year in March. On Day 1 of the conference, I wrote down several topics that I have expertise in. I settled down