Documentation

[Cayan]

Should we add a requirement for any type of documentation generator tool?
Are we going to enforce an specific API documentation pattern (like Swagger)?

[igorsantos07]

This sounds like a hard requirement to be made, as some frameworks may provide this out of the box and some others don't - scaring those lighter guys out of the project.

This could be an optional requirement, such as HEAD/OPTIONS are.

[Cayan]

I agree this should be optional, this is an extra feature and would be most useful if a repository serves as an skeleton project.

The idea behind this issue is just to discuss an API documentation format and if it should be automated.