Documenting APIs with OpenAPI is crucial for successful integration and adoption by developers. While reference documentation is important, other types of documentation such as code examples, getting started guides, and change logs enhance the developer experience. These elements together form a robust user interface for developers, facilitating easier API consumption and increased value for API consumers.