documenting and correcting gist-comments issues