3 ms·
To be fair, Waterluvian was talking about including pictures and tables and such in comments, while still writing actual code. It's probably still a horrible id
by a1369209993 8y ago
To be fair, Waterluvian was talking about including pictures and tables and such in comments, while still writing actual code. It's probably still a horrible idea, but for much more subtle (and less certain) reasons than "waaah, I don't want to have to do programming in order to make a program".
- fiedzia 8y agoPython+sphinx allows to get that (and a lot more).
- theaeolist 8y agoWould it be "a horrible idea" to include diagrams in code that implements a graph algorithm, or images in image-processing code?
- alkonaut 8y agoExactly this. Every sufficiently complex program that refers to graphs DO have those graphs. They are either in a separate document, or in the programmers head, or (poorly) added to the source code. There are plugins (e.g. for Visual Studio) that will render images refered to by file paths, in the editor. For complex graph-related stuff I imagine that can be pretty neat.
- maxxxxx 8y agoI would love to be able to include pictures and diagrams in comments. If it was in a text format like HTML or JSON it would source control nicely. The IDE could then display and allow editing them.
- flukus 8y agoSlap a text editor into doxygen documentation and you'd basically have this.