Recently, I have seen several articles talking about RESTful API design. Of course this is also a common topic of discussion for the engineers at Teem. I want to use (and write) APIs that are easy to understand and explain and the fastest way to complicate your API is nested routes. Just don’t do it! Do not create nested routes in your API. Let’s keep our APIs simple and create one endpoint per resource and if filters are needs, use GET parameters. This is simpler to document and simpler to maintain and ultimately, easier to use.
When I first started this blog, I started with My Management Philosophy. In short,
be a multiplier for your team and reduce friction… Successful managers make other people better at their jobs, “multiplying” their productivity.
When I wrote this, I was focusing on the ideas as a guide. “Should I do X? Does it multiply my team’s effort? Does it simplify their job?” Underlying this is that good leadership requires empathy and trust.
About a year ago we set down to document the core values of the engineering at Teem. After a lot of discussion we narrowed it to three core ideas
- maximize positive impact
- be a good friend
I would add one more unofficial value: mentorship and continuous learning. About the same time we also started thinking about how we describe/define an engineers career path and we quickly realized that measuring progress is hard and that measuring commitment to our core values is even harder.
Perhaps the one piece of ubiquitous technology that you will find at any new
tech company is
git. There are a couple of other technologies that you will
probably find, like AWS, but
git is the only one I expect to find everywhere. It is
also, surprisingly, many developers number one frienemy. I want to share some
of my favorite tips and tweaks that I have used over the years to make it all
friend and never my enemy.
At Teem, we aim for zero down-time deploys; so, one of the most important things we must validate is that things will not break mid-deploy!
The most sensitive step of the deploy process is the changes to our database. Prior to the automation I am about to describe, validation of the database migrations required specialized knowledge about Postgres, the changes to the application model, load on the database for that model, and a bit of general experience. This obviously slows down reviews and subsequently deploys. Worse, it was simply too easy to miss problem migrations when depending on only peer reviews. To make our lives easier we created a series of validation checks to ensure that each database migration will be backwards compatible.