balkian/balkian.github.com
1
0
Fork 0
mirror of https://github.com/balkian/balkian.github.com.git synced 2025-04-16 09:49:05 +00:00
Code Issues Releases Wiki Activity

add mention to Oxide

Browse Source
This commit is contained in:
J. Fernando Sánchez 2025-03-06 07:55:20 +01:00
parent 9148dba92e
commit 887cd28206
2 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

@ -6,3 +6,4 @@ output
*.pid *.pid
*.pyc *.pyc
_gen _gen
*/_gen

4
content/post/efficient-collaboration.md
View File

@ -257,6 +257,10 @@ Whenever a member asks you something useful that is not documented, don't just a
Take the time to add this information yourself (e.g., by copy-pasting your response) or task that member with expanding the documentation themselves once they find an answer. Take the time to add this information yourself (e.g., by copy-pasting your response) or task that member with expanding the documentation themselves once they find an answer.
If your organization's culture does not encourage using these docs, they will quickly get outdated and fall out of use. If your organization's culture does not encourage using these docs, they will quickly get outdated and fall out of use.
One example of taking this documentation approach really seriously is [Oxide (computer company)](https://oxide.computer/).
They have a process they call [Request For Discussion (RFD)](https://rfd.shared.oxide.computer/), which they use to discuss and document both technical and organizational decisions.
For instance, they have [RFDs on why they record every meeting](https://rfd.shared.oxide.computer/rfd/0537), [RFDs about their choice of database](https://rfd.shared.oxide.computer/rfd/0110), and even [an meta-RFD that discusses the motivation RFDs and how the process should work](https://rfd.shared.oxide.computer/rfd/0001).
#### Trust your teammate's ability to learn #### Trust your teammate's ability to learn