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 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

Google I/O 2017 Recap: Things I learned

Google I/O 2017 was a lot of fun and informative. I wish I had Hermione's Time-Turner as there were many talks to attend and many amazing people to meet.
Here are some things I learned at I/O: AI & Machine Learning This year, I/O was all about AI on every Google product. A product mentioned at the Keynote was Google Lens which enables your smartphone to take pictures of an image like a flower and identify it. That's pretty helpful for a hobbyist gardener like me. 
I also happened to drop by their Android Experiments sandbox and play the AI powered Quick Draw with fellow I/O attendees.
Google Assistant  Google's voice assistant is available on many devices now - not just on your Google Home & Pixel phones but on Android TV as well as iPhone. It's also available on more languages and has an Assistant SDK.You can build an app fairly quickly with Actions on Google and there is a challenge at g.co/ActionsChallenge. You could possible win a trip to I/O 2018 if you e…

Moderating my first panel - Ask an Android Developer

Every month at Android Alliance which I help organize, we have a monthly speaker and a few lightning talks. Someone in the Phillydev Slack group's android-philly channel suggested doing a panel for the June meetup.

I have been a panelist before but this time I wanted to try moderating. To prepare for that, I googled how to be a moderator and found Cate Huston's blog on moderating as well as this book - The Eloquent Woman's Guide to Moderating Panels recommended by Cate. The book is a quick read on moderating panels and has several pointers on how to moderate effectively.  

Of course, a panel is only as good as its panelists and moderator. For the panelists, I reached out to Corey, Travis, Nick & Arpit.  

Here are some things I set out to do as a moderator:
Set the toneWhen we start an event at Android Alliance, we go around and ask everyone to say their name, what they do and a fun fact about themselves. This usually makes it an informal atmosphere and lbreaks the ice qu…