If you have one artefact to give to someone, this is it.
This covers everything from the ground up, assumes nothing, and points to other sources of truth.
About Technology Company values & desirable behaviours Organisation model / how are we structured How do we make decisions Working practices Communicating Documentation File sharing, documentation & record keeping Communication tools Development practices Technical practices & process Team practices & process People practices Tools Recruitment Career management Tribe practices & process Onboarding Identity Where do we work?
Technology is the combined title for Product, Development, UX and QA.
When working as an technologist, if in doubt, go back to the core values
Company values & desirable behaviours
What do we value?
How do we make decisions? – ?
What behaviours and skills do we care about promoting?
Interacting with others
Ownership and decision making
Who’s responsible for what decision? (eg who has what responsibilities?)}
Tribe model, responsibilities, sub-dept relationships Product, UX, QA and Development.
This includes the RACI index for all-of-the-things
How do we make decisions
Above all, documentation should be useful! We want everyone to contribute to evolving the information available around Technology, so if you find something wrong, either fix it or leave a comment, and someone will look at it in the fullness of time.
“Documentation” in this context means anything you’ve written down for your future self. It could be code comments, architecture documentation, culture documentation (like this!) or even process documentation.
Not everything will be written down, some situations will be entirely new and
File sharing, documentation & record keeping
There are VMs for development Technical practices & process
Team practices & process
Tribe practices & process
Where do we work?