Lessons: Nigeria health story hacking

Nuno Vargas invited me to mentor at a hackathon for the International Center for Journalists Hala Nigeria program, a health journalism/technology initiative. The two-day boot camp helped teams from Nigerian newsrooms turn their print stories into useful digital tools.

I gave a short presentation and helped teams design and build their projects, but of course I also learned from having my American newsrooms experiences challenged.

Build for users

Hala Nigeria journalists had intimate knowledge of their audiences — rural mothers, commuters, malaria patients, Ebola survivors — thanks to their reporting in the field. A design thinking talk by Nuno guided content and technology decisions, and Knight fellow Justin Arenstein demo’d some amazingly useful Code for Africa projects.


The news apps I’ve built look nice on desktop computers, but everyone at the Hala Nigeria camp understood their audience uses mobile phones. We discussed social media and the differences between native and responsive apps and tested prototypes by whipping out cell phones.

SERIOUSLY, MOBILE (especially feature phones)

Anecdote: I was one of the only iPhone users at the story camp.

Survey: According to slides 11 and 12 of the TNS Global report below, 82 percent of Nigerians own a mobile, but only a quarter of them use smart phones. The vast majority are on feature phones.

Texas Tribune taught me to think responsive, many of the apps I developed for and tested with smart phones would be useless to many Nigerian mobile users.

Problems? Hack nah!

Projects focused sensitive health issues in rural areas of Nigeria. In the absence of data, many of the teams created forms and developed marketing strategies to build custom datasets with input from their target audiences.

Martin Virtel also offered an example of an impactful app that only required two numbers.

Reporters rock

Vanessa Odinong’s reporting on maternal health issues in Northern Nigeria reminded me of Texas Tribune’s focused women’s health coverage. Ayeni Gbenga’s artistic eye and reporting interest immediately amde me think of the comics journalism of Darryl Holliday and Washington Post. Temitayo Olofinlua pursued medical negligence stories as aggressively as I’ve seen any statehouse reporter track down official documents.


Paying technical debt dues

The Texas Tribune didn’t just hire me to play third base on its softball team, although my performance in the absence of the injured photo editor definitely helped keep me in Austin for the past year.

My primary responsibility was to rebuild the government salaries website, an ambitious project to open the compensation information of Texas public workers by sending lots and lots of open records requests to countless state agencies.

Gender and ethnic salary analysis were new features of the rebuilt salary app.
Gender and ethnic salary analysis were new features of the rebuilt salary app.

Former Tribune developers built the original site in 2010 and was received much like other salary sites. It generated so much traffic and criticism from the individuals represented in the data that publisher Evan Smith had to write a blog post.

Why rebuild such a popular app? Technical debt.

The salary site was supposed to be updated when Tribune staff received information from their records requests, but the app fell woefully out of date because importing data was complex and time consuming. Tribune staff paid in the price in daily angry emails from state workers who were upset that anyone could find their outdated salary with a Google search.

Government Salaries v2.0 became my primary task in February. The MVP had three goals:

  1. Reduce technical debt
  2. Reduce angry emails
  3. Provide new analysis

Most of my work on the six-month project focused on importing and storing data. The new app used a rebuilt import process, an open government data schema championed by Travis Swicegood in his ONA talk and Docker for deployment. I looked to metrics, wireframes and user personas for design guidance and tested features as prototypes with the newsroom.

My paper prototypes looked rough.
My paper prototypes looked rough.

I was disappointed that I did not provide users transparency into the development process, a concern that was raised at the Hacking News Leadership conference in Austin. The status of the salary site is of great importance to state workers, and a development blog explaining our progress would have answered many emails and phone calls.

I moved to Los Angeles to be with my partner before the new salary app launched, but Ryan Murphy, Daniel Craigmile and Alex Duner did a great job carrying it to the finish line. When the app went live Thursday, I was both excited for users to finally see new data with gender and ethnic breakdowns and stunned to see months of work published.

Of course the project is not complete. In addition to updating the data, I hope my code and documentation help future developers add features and provide insights into Texas public agencies. I understand the relaunch generated more than 200 emails, and I wish those developers well in responding to them.

Novice skeptic considers race, technology, media

No matter how many Ferguson vines and live streams I watch, I haven’t experienced it. I’m not Mike Brown, I haven’t been tear gassed and armored vehicles aren’t driving my block.

Ferguson resonates with me, and modern technology lets me watch conflicts live from my apartment like never before. However, skepticism makes me question how I can convey and understand the experiences of others as a journalist and a news consumer.

I’ve been on philosophy binge. David Hume’s empiricism spoke to my work at The Texas Tribune, where I combed datasets for newsworthy information. I was already questioning the truthiness of my data, and Hume’s thoughts about knowledge coming from experience sync with the Bayesian statistical methods that were developed around the same time as Hume’s writings.

Recent readings also affirmed my experiences interviewing families with terminal illnesses for Inheritance of Hope. Each month for the past three years, I have written about parents who were told they have terminal diseases, but I still feel like my reports are incomplete. I can’t comprehend illness in the ways those families can.

I connected with Elaine Scarry’s claim that people are better at empathy than sharing actual physical feelings like pain. Physical feelings are tied to specific experiences, and Scarry channels Hume, who distinguishes “impressions” from “ideas” and claims that all ideas and facts are products of experiences.

Likewise, racial tension is rooted in past experiences. If I don’t have those experiences, how can I convey them as a journalist?

When Hume writes, “a man in a fit of anger is actuated in a very different manner from one who only thinks of that emotion,” I think of the Dr. Martin Luther King, Jr. quote, “a riot is the language of the unheard.”

I also recall the powerful response Angela Davis gave to a reporter who asked her about violence: “The person who’s asking that question has absolutely no idea what black people have gone through.” (4:52)

They’re telling me I need experience to understand.

Media gives me windows into other experiences. Black twitter creates discussions like #IfTheyGunnedMeDown, and activists can broadcast sights and sounds nearly instantly. Video and the definitive account it provides, which we learned from Rodney King, inspired petitions to require cameras for police officers after Mike Brown. I love the idea that technology can inform and empower.

Although media reflects these emotions and events as images and sound bites, I can’t take the place of a protester. I can’t actually have the experience with media, and that makes a difference. The history of racial segregation created what President Obama recently called a “gulf of mistrust,” and affects how we perceive events. The divides continue even in our connected lives with social media algorithms that create “filter bubbles” and distort information streams.

At least Antonio French, the alderman who has been at the Ferguson unrest nightly, can post his personal account to his Twitter stream. Without his tweets and videos, I would not have those glimpses from his perspective, even if they are brief glimpses.

However, I wonder what social media is unable to tell me about the black experience in St. Louis.

Note: My dive into skepticism started with a video of young adult writer John Green playing XBox.

Sampling static site generators

I’m coming clean: I’ve been writing on other blogs. It’s not that I don’t love this WordPress site I built as a college freshman with a homepage carousel and fixed-width containers, but some side projects presented opportunities to try generating websites with Jekyll and Yeoman.

I was inspired to start a datablog about about the legendary bearded pitcher Brian Wilson after reading Analyzing Baseball Data with R and wanted a website framework that would allow me to publish easily but also facilitate sharing the R code I used in my analysis.
Jekyll and GitHub fit my situation because I could deploy scripts and blogs to the same place. I suppose I could have used iPython notebooks or Jeremy Singer-Vine’s Reporter to embed my code more seamlessly in posts, but for now I link to the repo.
Originally I thought Jekyll’s use of markdown would block all the Javascript I planned to do with this project, but I’ve ended up embracing static charts and gifs, which are simple to embed in markdown.
I wanted to use the yeoman Backbone generator to get running with a single-page site that used my work examples as data models but into command-line setup struggles. After 15 frustrating minutes, I found my Node needed an update.
My first go with Yeoman wasn’t as snappy as I hoped, and my time allotment broke down like this:
  • updating node: 1 hour
  • fighting backbone models: 1/2 hour
  • writing my resume as json: 2 hours
  • design: 1/2 hour
  • deployment: 1/2 hour
Using Backbone to treat my resume as models meant I had to write my resume and work samples as json. I was willing to put up with the hassle because for some reason I like entering structured data by hand, but this is why lots of people have worked on ways to convert spreadsheets or google docs to structured data and I could have used those tools.
Deploying my yeoman-generated portfolio site was bittersweet as it was only once I put it on the interwebs that I realized the generator had included some libraries that broke Backbone on Internet Explorer. The generated site came with modernizr and had fallbacks to help IE users, but I would have rather handled IE myself. I could pick through the yeoman generator, find what breaks my site on IE and remove it, but I’m lazy.
Give me the grid
You gotta have a responsive grid. Yeoman generators come with one, Sass tools like Bourbon Neat can give you one. However in recent collaborations with my boy Frank Bi, we’ve used good ol’ Bootstrap since we both understand CSS and want avoid grunt/compiling Sass.

Hardware hacking with Arduino’s temperature sensor

Dad always kept it cool in the house, just like his native bay area. With a cold front moving through Texas this weekend, I thought I’d use my Arduino’s temperature sensor to track the overnight temperature of the unheated living room and compare its readings to the actual outdoor temperature.

I modified sparkfun’s temperature sensor example to log every minute, let the sensor run from 11 p.m. to 11 a.m. Friday night and plotted the indoor readings against the hourly outdoor recorded temperature.

Outdoor temperatures at the minute level would provide better comparison, but I was surprised to see how small the difference is.

Twilio was nice to hook my teammates and I up with open-source Arduino boards for best use of their SMS service on voting wait time our project for a hack in New York last summer. Tools like Arduino offer exciting opportunities for folks interested in sensor journalism, but I’ve found it tricky to find newsworthy applications of hardware sensors. Recording the overnight temperature of my apartment was a simple experiment, but I look forward to more.

Fortunately the Texas Tribune nerds let interns tinker in the newsroom.