it asks for my name, then my "short description", then "details". OK, so my short description is that I'm a coder, and perhaps I don't want to enter a long description, so I click "save" --> surely the next page will ask for my comment, right? (The form does indicate "please fill out this field" if I leave short desc empty, so by that point I'm probably annoyed that it's asking for so many personal details. It's good that it doesn't *require* my whole bio!).
I think there should a clear separation between the two fields on top and the two ones at the bottom. Maybe just a line of text that says "Please enter your documentation comment below".
Not entirely correct. In this example, "student" was written under "details". And "coder" under short description.
But yes, those fields are clearly badly named. How about we just name them "subject" and "comment"?