I am working on transitioning our team to have full service ownership. The first step I took is to document one service, following service documentation guide.
A wiki page for this documentation and each project’s readme will be for lower-level documentation (how the code is organized, how to call the API, any extra details needed, etc).
The dilemma is what is the best practice for service documentation? Should it live on each service’s readme files, a new section in our wiki or a new “docs” local website that is focused only on service documentation (based on PD’s gihub)?