Where should a programmer explain the extended logic behind the code?

Posted by SRKX on Programmers See other posts from Programmers or by SRKX
Published on 2012-04-05T14:54:52Z Indexed on 2012/04/05 17:44 UTC
Read the original article Hit count: 219

I have developed a few quantitative libraries in C# where it is important to understand not only the classic information that goes with the XMLDoc comments (which contains basic information with the method signature) but also the mathematical formulas being use within the methods.

Hence I would like to be able to include extended documentation with the code, which could contain, for example Latex formulas, graphs, and so on.

Do you think such information should be included in the API documentation?

Or should it be included in a dev blog for examples?

Are there common tools that are usually used for this kind of purposes?

© Programmers or respective owner

Related posts about documentation

Related posts about documentation-generation