Foreward

This book is a result of over a year of experimentation within Elastio with the best way to communicate our approach to software engineering to existing team members and especially new hires. As an early stage startup working with Rust at a time when that language was undergoing rapid change, best practices went from "best" to "deprecated" very quickly. At the same time, rapid growth in our Engineering team meant new members were joining the team with no formal Rust experience and no better way to learn the ropes then submit code in PRs only to have to rewrite it in response to a torrent of feedback from more experienced members.

It became clear that we needed a better way. The result is this book. We hope it achieves the following goals:

  • Easily accessible content that's easy to read and understand. English is not the first language for most of our team.
  • Always up to date because updating the book is as easy as editing markdown and making a PR to this repo. Netlify makes this particularly easy.
  • Broadly applicable outside of Elastio. While the primary audience for this book is members of Elastio engineering both new and seasoned, much of the content is derived from practical experience building commercial software at scale and should be useful to readers facing similar challenges in other organizations.

If you find errors, omissions, or obsolete information anywhere in this book, you're encouraged to open a PR. If you're an Elastio engineer, it's literally part of your job, but even if you're not we welcome contributions from our fellow software engineers outside of Elastio.