diff --git a/README.md b/README.md
index bc9bb2f5..b0b9f6fe 100644
--- a/README.md
+++ b/README.md
@@ -251,7 +251,8 @@ _currently supported providers are `google`, `facebook` and `github`_
 type Comment struct {
     ID        string          `json:"id"`      // comment ID, read only
     ParentID  string          `json:"pid"`     // parent ID
-    Text      string          `json:"text"`    // comment text
+    Text      string          `json:"text"`    // comment text, after md processing
+    Orig      string          `json:"orig"`    // original comment text
     User      User            `json:"user"`    // user info, read only
     Locator   Locator         `json:"locator"` // post locator
     Score     int             `json:"score"`   // comment score, read only
diff --git a/app/store/service.go b/app/store/service.go
index c354c8dc..28583521 100644
--- a/app/store/service.go
+++ b/app/store/service.go
@@ -88,6 +88,7 @@ func (s *Service) Vote(locator Locator, commentID string, userID string, val boo
 	return comment, s.Put(locator, comment)
 }
 
+// EditRequest contains fields needed for comment update
 type EditRequest struct {
 	Text    string
 	Orig    string