4 ms·
I agree that docs and code comments should complement each other. As a visual learner, I find diagrams showing how classes/objects fit together to be much more
by blackflame7000 7y ago
I agree that docs and code comments should complement each other. As a visual learner, I find diagrams showing how classes/objects fit together to be much more helpful than reading the documentation. A picture can replace a thousand words and tools like Vizio/Yed are really helpful in my opinion while at the same time minimizing the amount of documentation.
- HighPlainsDrftr 7y agoI'm sort of the opposite. Diagrams just show an abstract to me. At a high level they are great, but I always find myself trying to dust off the diagram and figure out what really is happening underneath. Its always so damn complex!