Development Practices The Value of Writing About Bugs A good bug-fix story has a lot of value. I want to explain why I think developers should spend more time writing about bugs.
Development Practices Keep Your Documentation Up to Date with a Checklist I've recently utilized a Documentation Checklist to help keep my software documentation up-to-date while saving time and effort.
Effective communication Building a Generalist Marketing Team: The Case for Documentation When building a generalist marketing team, documenting your tasks pays dividends long-term, from onboarding to switching tasks.
Effective communication Expedite Development with Minimum Project Documentation Something that helps expedite development is having the minimum amount of project documentation at the right level of detail.
Development Practices 5 Types of Software Documentation & Tips to Manage Each Today, I'll cover five different types of documentation in software development, with tips on how to use them as effectively as possible.
Development Practices A Checklist for Documenting Your Public-Facing API Here, I'll walk through the different forms of public-facing API documentation and developer tools that we added at different phases of the project.
TypeScript Automate API Documentation and TypeScript Types with OpenAPI Recently I was tasked with updating the API documentation on a project to OpenAPI format. Here's how to get started using it in your project.
Developer Tools Create Easy GraphQL API Documentation with SpectaQL and GitLab Pages Easily generate a GraphQL API documentation site based on your annotated GraphQL Schema using GraphQL docstrings, SpectaQL, and GitLab Pages.
Growing as Makers Document Your Process to Teach and Learn a New Task Well One thing that’s helped me teach and learn new tasks is our team’s emphasis on documentation and a defined way to pass along process.
Project & Team Management A 4-step Checklist for Transitioning to a New Job When transitioning to a new job, it can be easy to get caught up in excitement about the new position. Here are four ways to prepare for your departure.
Development Practices Document All the Things Before Handing Off a Maintenance Project Before handing off a maintenance project, here are items you should document or get from the client or the previous person who worked on it.
Development Practices Better Documentation Through Low-Fidelity Diagrams Low-fidelity diagrams generate more accurately documented systems than complex master diagrams. Here's how I use them on software projects.
