We can't find the internet
Attempting to reconnect
Something went wrong!
Hang in there while we get back on track
James Ford at StaffPlus London 2023
Explore the importance of effective documentation in achieving lasting impact, influencing others, and building credibility, while considering audience needs, personal biases, and context.
- The goal of documentation is to have a lasting impact, not just a temporary one.
- Good documentation should be thought-provoking, influencing, and scalable.
- Documentation is not just for knowledge sharing, but also for verification and credibility.
- Assume that people will correct your mistakes and lend credibility to your work.
- Nothing should be implicit or unwritten; clarity and transparency are key.
- Documentation should be maintained and updated regularly to ensure its longevity.
- The author’s responsibility is to create content that is clear, concise, and well-structured.
- Documentation is a starting point for conversations, not a replacement for human interaction.
- People’s perception of documentation depends on their context and background.
- Effective documentation can make it easier to scale influence and impact.
- Documentation can be influenced by personal biases and perspectives, but it’s essential to be transparent about them.
- Consistency, coherence, and simplicity are crucial for good documentation.
- Credibility and trust are built through documented processes and decisions.
- Documentation is a form of proof of work and should be maintainable.
- It’s essential to consider the audience and their needs when creating documentation.