Permalink
Browse files

Couple o' shipped posts

  • Loading branch information...
1 parent 3e8d059 commit 1362edb0e3b2984ce63734753d4cd5104543c2f6 @kneath committed Jun 6, 2010
Showing with 43 additions and 0 deletions.
  1. +34 −0 github/_published/inline_commit_notes.md
  2. +9 −0 github/gist_comments.md
@@ -0,0 +1,34 @@
+<!-- -*-Markdown-*- -->
+
+In [Ryan's Compare View post](http://github.com/blog/612-introducing-github-compare-view) we promised that we'd be rolling out more code review features and toady we're rolling out the latest: inline commit <strike>comments</strike> <ins>notes</ins>.
+
+## Comments → Notes
+
+GitHub has actually had commit and line-based commit comments for a very long time. The problem was they were tucked into a facebox activated by a little bubble peeking out of the side of the source. Hard to find.
+
+<div class="figure"><img src="http://share.kyleneath.com/captures/Dock-20100326-121823.jpg" alt="Example of old style" /></div>
+
+Now, we've moved the comments inline and we're calling them **notes**. This terminology helps distinguish commit notes from comments on issues and other places.
+
+<div class="figure"><img src="http://share.kyleneath.com/captures/Dock-20100326-124550.jpg" alt="Example of old style" /></div>
+
+As a side-note, we've also deprecated file-based commit notes (that is notes that are attributed to a file, but not a line). Old comments will continue to show up indefinitely, but you will no longer be able to add them.
+
+## Highlighting important people
+
+The new note styles also help to highlight people who you might want to listen to -- notably repository owners & collaborators.
+
+<div class="figure"><img src="http://share.kyleneath.com/captures/Dock-20100326-124826.jpg" alt="Example of old style" /></div>
+
+## Publish notes like a pro-fessional
+
+Previously with the old commit comments only repository collaborators could delete comments (and no one could edit them). Now you can edit and delete your own notes (in addition to repository collabs).
+
+<div class="figure"><img src="http://share.kyleneath.com/captures/Dock-20100326-123313.jpg" alt="Example of old style" /></div>
+
+Another source of pain was the fact that you could only preview your comment under specific conditions. Now you'll see that everywhere you can make a note, there's a handle little preview tab that will give you a live preview.
+
+<div class="figure"><img src="http://share.kyleneath.com/captures/Dock-20100326-122933.jpg" alt="Preview comments" /></div>
+
+Things are a little rough around the edges, so let us know if you run into any issues using these new inline notes!
+
View
@@ -0,0 +1,9 @@
+<!-- -*-Markdown-*- -->
+
+Commentastic: Gist Comments & Blog Comment Improvements
+
+Ever wish you could comment on a gist? Well now you can!
+
+<img src="http://share.kyleneath.com/captures/gist__349421_-_GitHub-20100330-145149.jpg" alt="gist comments" />
+
+We've also updated the blog comments to the new style as well. And of course you can edit and delete all those comments too!

0 comments on commit 1362edb

Please sign in to comment.