On Thursday, October 20, 2022 at 7:59:40 AM UTC-5 Edward K. Ream wrote: We recently discussed the role of comments and narratives in our programs. > coverage has some of the best docstrings I've ever seen. Two longish > examples: [snip] >
Notice the contingent and pragmatic nature of these (excellent!) comments: - They depend on the actual code: they could not have been written beforehand. - They are *not* part of a general narrative: they discuss low-level details or bugs. Edward -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/leo-editor/8b7394d1-74ba-4f1c-bef2-051734c22a8en%40googlegroups.com.
