Glossary #5

• Comment - avoid this word because it is ill-defined
• CommentSpot - the logical location of a comment. Such as new comment on github.com issue diffplug/selfie#37
• CommentDraft - the specific contents of a CommentSpot at a specific instant in time
• CommentEnhancer - an interface which takes a raw textarea, determines if it represents a known CommentSpot

If you think any of these terms are unclear, feel free to discuss below. If there are any other concepts in the code which should be defined explicitly, feel free to discuss below. The final result of all discussions is incorporated into the list above via editing, after which the discussions may be deleted. This glossary is based on an idea from Rich Hickey's Design in Practice talk.