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

7. You can put them in the source where they are relevant.

Got a hairy state machine? Stick a comment at the top with something like nomnoml's syntax and anyone can follow what's going on without having to trace through the code.



> 7. You can put them in the source where they are relevant.

> Got a hairy state machine? Stick a comment at the top with something like nomnoml's syntax and anyone can follow what's going on without having to trace through the code.

For that use-case a markup graph language is a poor solution. Use https://asciiflow.com instead to produce something that people can digest without needing a third-party tool that may not even exist anymore.




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

Search: