DEV Community

Discussion on: The end of text documentation! 👨‍💻👩‍💻

phlash909 profile image
Phil Ashby

I can see how this might work (for those who like to consume video content, and for recording decisions about internal code structure), but for the bigger picture, I find there is nothing quite so useful as ..... a picture 😄

Often it's the design process, the drivers and decisions taken to reach a conclusion (the hopefully working code) that really matter. Over several years of communicating this stuff to others, I found there was nothing more effective than drawing on a whiteboard, taking pictures as things changed and writing up the thinking process (ie: explaining the series of pictures), usually in written word, and sometimes presented to teams, so they can interact, ask questions, clarify understanding and subsequently improve the words and pictures.