??? 03/19/10 14:44 Read: times |
#174319 - Unfortunately agree Responding to: ???'s previous message |
Oliver Sedlacek said:
Of particular note I'm annoyed by ... Poor coding standards I'm afraid I would tend to agree. :-( Someone made the same comment recently on the STM32 forum; this was my reply I said:
ST (like too many others) seem to have totally missed the point and target audience of "sample" or "example" code:
* The Purpose is to inform and explain; * The Target Audience is people who are not familiar with the software and/or the hardware. Clearly, these are not served by terse and/or sparse comments, nor by using any kind of "clever tricks" in the source code. Sample code needs to be exemplary in both the quantity and the quality of its comments, and those comments need to clearly describe each step of the process, and each variable used, and the project settings, etc - as well as giving an overview! "It'd be nice if there were lots of comments to explain what is going on." Not just "nice" - absolutely essential if it is to serve its purpose as example code! "Then again how many people do that?" But "most people" are not writing example code! The specific purpose of example code requires it! https://my.st.com...tviews=333 |