Code should not be documented

[platipodium]

Code should be self-documenting as much as possible. Apt variable and function naming, explicit statements, short documentation only where functionality is obscured by code for exceptional reasons.

OMF as an organization should not delve into the code documentaiton but focus on model documentation (which could be in the code)

[platipodium]

Code should be readable by machines and humans alike. Code is documentation. Where this is not possible, annotations that explain the code are part of the code, targeting the human where the obscure only caters to the machine.

[alee]

Clean, modular, well-written code is a concern for all aspects of model reuse and interoperability it's not really clear what is being proposed here besides the issue that OMF should not mandate clean code (though we may mandate that the code meets community standards, however those are defined)

I'll convert this to a discussion if you'd like to talk about it further.