Hacker News new | ask | show | jobs
by rzazueta 1558 days ago
I feel like I just gave the marketing side of the answer... completely forgetting the advocate side. Sorry.

On the advocate end, as a developer, you already know how your peers work, what frustrates them what delights them, etc. Expand your audiences and see what other developers using other languages in other organizations are doing and start to build your own thesis on what makes for a good developer experience - portals, documentation, outreach, code and API design, etc.

Read some technical books and blogs focused more on the design of the things you;re interested in rather than the usual nuts and bolts O'Reilly type stuff. Get a sense for what others are advocating for in your area of focus and determine whether you agree or not. More importantly, work on articulating why you agree or don't. Like, really dive into that stuff - that's where you'll find the kind of knowledge that will help you better build a strong thesis you can share with others as well and find solutions and opportunities to improve processes and tooling. Then, start advocating for that better way - experiment with things, talk to your peers and get their feedback, then collect it all and publish it.

I became passionate about APIs and API design a while back because I was managing an API program that, while solid, left a lot to be desired. I spent a lot of time researching APIs and API design - we're talking 2009 here - and there was just starting to be a wellspring forming around RESTful APIs. But one of the key challenges I saw was that no one really could explains what RESTful was - even the experts.

I set about transforming the SOAP API we were using into a RESTful design - not coded, mind you, just the design. Even though I wasn't on the engineering team, I brought my design to the VP of engineering and they wound up using it as they refactored the code.

This eventually led to a gig as a strategy consultant with an API management company where part of my job was to go on stage and share our research in order to build our credentials and sell our services. I took my interest in API design and turned it into a new service for us to offer our customers, then went on stage all over the place to introduce my methodology. I've basically been riding that wave ever since.

Cool story- a number of years later, I had a meeting in Lisbon with a major Portuguese company to help them define their digital strategy. As I was delivering my high level overview of API architecture and design, I saw this dude who was part of the engineering contingent furiously typing on his phone. I assumed I had lost him and figured, "Fine, I'll make sure he;s paying attention when I get to the tech stuff."

At some point, I brought up my API design methodology, and he suddenly blurted out something like, "THAT'S who you are!" He was trying to figure out why he knew me and had been Googling for the answer. Turns out, he and his team had been using my site to train themselves on API design and were rather devoted about it. That was nifty.