Documentation Explained
In Archipelo, we follow the document-first approach, which means we default to starting things with documentation. To maintain a clean hierarchy of the documents and make it simple to find them later, it is important to stick to the rules.
caution
All documents are considered confidential by default and cannot be redistributed outside of the company.
Tools
Tools used for creating, editing, reading and storing documentation:
- Markdown files in GitHub
- Miro
- Figma
- Notion
- Loom
- Google Drive
- Google Docs
- Google Slides
Document types
Below is a graph showing different types of documents and which tool should be used to create them.
Click here to open in a separate tab.
For easier search, below is the same data shown in a dropdown list structure:
Graphics
Figma
- Design documents (wireframes, branding, prototypes, user flows, mockups)
Enriched Text
Documents containing mostly text, but enriched with graphics, charts etc.
Figma or Google Slides
- Presentations / slideshows (roadmaps, board-decks)
Miro
- Scrum Ceremonies (Sprint Retrospective)
- Design Thinking Sessions
- UML Diagrams
- Charts, Graphs, Mindmaps
Notion
- Personal Portfolio
- 1:1 Meeting Notes
Text
Google Docs
- Research docs
- Meeting Notes
- Reports
- PRD (Product Design Document)
- Drafts
GitHub
- ADR (Architecture Decision Record)
- Post-mortems
- Technical documentation (Software Environments, Release Process, Testing Process, Infrastructure, README files, etc.)
- Company Protocols (Time Off Policy, Remote Practice, Recruiting, Task Management etc.)
- Company Info (Values, Members etc.)
Videos
Google Drive
- Meeting Recordings
Loom
- Screen Recordings
Videos
Google Drive
- Articles
- PDF Files
- Spreadsheets