Development - write a description of how some existing features work

Quoting rabidfury from this comment:

I think a similar high-level walkthrough would be helpful here. When I click "submit" on a new post, what happens? When someone comments on my post, what happens? What triggers the orangered notification for me, how do the "X new comments since your last visit" counters get maintained, etc.