Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Could this kind of documentation be an exception? After all, it can be quite hard to edit these pictures.


I think you want to lean heavily into the words and use pictures sparingly where they really add value. They're also not completely uneditable - you can just dump them back in asciiflow and fiddle with them if you want to make a change.

I also find that usually the pictures capture a fairly high level structural concept - the sort of thing that changes a bit less. Sometimes I do a message sequence chart and editing to add an extra message is usually pretty easy.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: