May 2018 Summaries

Many companies are adopting microservices to allow different teams to work independently on various parts of a codebase, similar to APIs but for internal use, necessitating proper documentation. ReadMe, typically used for documenting external projects, is also employed to document internal microservices, allowing users to add multiple Swagger/OpenAPI Specs to reference docs. However, to prevent page slowdowns and improve organization, ReadMe offers a feature to place each Swagger file on a separate page, enabling easier navigation, though it currently requires contacting support to activate. Authentication options to secure these documents include global passwords, admin-only access, and OAuth for more granular control. To automate the documentation process, ReadMe provides a command line tool, rdme, and supports Swagger Inline, allowing documentation to be generated directly from code comments, facilitating seamless integration into build processes.