Docs are helpful not just to people implementing t...
# http4kx
xenomachina
04/23/2018, 5:28 AMDocs are helpful not just to people implementing the interface, but also people who have to interact with objects that implement it, as well as contributors to http4k itself. In my own code I frequently go back to the doc comments I wrote to remind myself what guarantees were made about what. At the very least, if there are public interfaces that clients should not be implementing, shouldn't that very fact should be documented in the code?