Robert Mustacchi, a key player in Oxide's Requests for Discussion (RFD) process, joins the conversation to share insights on how RFDs shape the company's communication and decision-making. They dive into the humorous intricacies of office politics and the evolution of documentation practices, contrasting Markdown and AsciiDoc. The importance of transparency in RFDs is emphasized, as well as their role in onboarding new team members. Plus, they tackle how documentation fosters knowledge sharing while addressing past decisions and innovations in technology.
Read more
AI Summary
AI Chapters
Episode notes
auto_awesome
Podcast summary created with Snipd AI
Quick takeaways
RFDs serve as a vital tool within Oxide for transparent communication and collaborative decision-making across various organizational topics and processes.
The evolution of RFDs from informal notes to structured documents illustrates their increasing importance in enhancing organizational memory and guiding strategic choices.
Open-sourcing the RFD framework encourages broader community engagement, fostering innovation and shared knowledge through feedback and collaborative practices.
Deep dives
The Significance of RFDs
Request for Discussion (RFD) documents are essential to the structure and decision-making process within the organization. They serve as a mechanism for articulating ideas, decision-making, and documenting processes, which promotes transparency and collaboration. The history of RFDs at the company illustrates their evolution from a basic framework to a vital tool that informs operational and strategic decisions. As RFDs are open-sourced, they provide an opportunity for others to learn from and adopt similar practices.
Evolution of the RFD Process
The RFD process has developed over time, beginning from informal notes to a structured format that encourages detailed discussion and review. The early RFDs focused on basic principles and values, which laid the groundwork for future processes, including hiring and operational standards. The shift to a more organized RFD framework has allowed for increased collaboration, capturing essential insights that should remain visible for future reference. This evolution highlights how documenting thought processes leads to stronger organizational memory and improves overall decision-making.
Comparison of RFDs to Historical Practices
The discussion around RFDs draws parallels with previous engineering documentation processes, such as the architectural review system experienced at previous companies. This traditional approach often led to bureaucratic hurdles and did not necessarily foster collaboration, which RFDs successfully mitigate. By offering a more open and less formal process, RFDs encourage brainstorming and discussions without the fear of formal approval, allowing for quicker iteration and innovation. The lessons learned from past experiences have shaped the current implementation of RFDs, making them more user-friendly and engaging.
Implementing RFDs in Engineering
Integrating RFDs into engineering practices has yielded numerous benefits, particularly in fostering a writing-intensive culture among engineers. Each RFD serves not only as a record of decisions but also as a tool for collaboration, allowing engineers to contribute to the ongoing evolution of projects through written discourse. This has proven especially useful when developing complex systems, as RFDs enable cross-functional teams to remain aligned and informed about technical choices. Furthermore, the flexibility of RFDs allows teams to address challenges in a timely manner, ultimately improving project outcomes.
Enhancing Accessibility and Usability
To improve accessibility, the system allows users to search and comment on RFDs efficiently while also managing permissions for various stakeholders. This capability is crucial for ensuring that relevant parties can contribute to discussions and access necessary information without confusion. The implementation of a robust commenting and permissions system has proven invaluable for managing the growing number of RFDs and users engaging with them. The ongoing commitment to refining the RFD process focuses on enhancing user experiences and ensuring relevant context is preserved for all involved.
Open Source and Community Engagement
The RFD system's decision to open-source its framework highlights an aim to engage a broader community while creating valuable documentation practices. By doing so, the organization not only invites other teams to adopt effective methods but also opens the door to feedback and collaboration from external users, fostering innovation. Providing access to the RFD framework can facilitate exchanges of ideas and improvements that may benefit both the organization and the wider engineering community. This open approach reflects a belief in shared knowledge and continuous enhancement of documentation standards.
RFDs--Requests for Discussion--are how we at Oxide discuss... just about everything! Technical design, hardware component selection, changes in process, culture, interview systems, (even) chat--we have RFDs for all of these, over 500 in a bit under 5 years. Bryan and Adam were joined by Oxide colleagues instrumental to RFDs, from their most prolific author to those making them more consumable.
In addition to Bryan Cantrill and Adam Leventhal, we were joined by Oxide colleagues, Robert Mustacchi, David Crespo, Ben Leonard, and Augustus Mayo.
Some of the topics we hit on, in the order that we hit them:
If we got something wrong or missed something, please file a PR! Our next show will likely be on Monday at 5p Pacific Time on our Discord server; stay tuned to our Mastodon feeds for details, or subscribe to this calendar. We'd love to have you join us, as we always love to hear from new speakers!
Get the Snipd podcast app
Unlock the knowledge in podcasts with the podcast player of the future.
AI-powered podcast player
Listen to all your favourite podcasts with AI-powered features
Discover highlights
Listen to the best highlights from the podcasts you love and dive into the full episode
Save any moment
Hear something you like? Tap your headphones to save it with AI-generated key takeaways
Share & Export
Send highlights to Twitter, WhatsApp or export them to Notion, Readwise & more
AI-powered podcast player
Listen to all your favourite podcasts with AI-powered features
Discover highlights
Listen to the best highlights from the podcasts you love and dive into the full episode