Stash 1.3 release notes
9th October 2012
Meet the new, more social Stash – introducing Pull Requests
Pull requests provide your team with a quick and easy way to review code changes made on a branch, discuss those changes, and make further modifications before the branch is merged back to master or your main development branch.
With Stash and Pull Requests, code reviews become an integral part of your development process. Development happens on branches and when code is ready to be merged into the main branch a Pull Request is opened. Unless the code has been reviewed as part of a Pull Request, it does not get integrated back into the main branch. All the benefits of code review baked right into your workflow!
Creating a pull request is like starting a discussion. Your reviewers can see the changes you have made, comment on those changes and commit further changes and improvements to the branch if required. When everyone agrees, the branch can then be merged back to master or your main development branch.
The essential thing about a pull request is the discussion that takes place around the code changes you are making. The overview captures the entire activity of the pull request. Comments on the diff, replies, or new commits to the branch.
Diffs for a Stash pull request highlight the changes that would result from the merge. The diff tree shows all modified files and, as you'd expect, you can click on any file to see exactly what has been added, deleted or modified. Threaded comments right in the diff allow meaningful and contextual conversations about your code.
A pull request is dynamic! Not only can there be a lively discussion about code changes, but participants can commit new changes to the branch. Stash auto-updates the Commits tab of the pull request, so you can see exactly which commits will be merged. Stash is smart about comments, moving them along when lines are added or removed. If a line with a comment gets removed, you can still view the comment in the activity, but Stash marks the diff as outdated to let you know that this piece of code has been changed in recent commits.
Whether someone added you as reviewer, commented on the pull request or merged your changes, Stash ensures you know what's going on by sending you email notifications about pull requests relevant to you.
Stash has an evolving set of keyboard shortcuts, to help you work faster. Click the link when looking at any repository to refresh your memory about the available shortcuts.
README – simple project documentation
Stash now provides an appealing, yet simple, way to document the project right in the repository by rendering the content of .md and .txt files in the file view of the repository. If the file uses Markdown, that gets rendered straight to the screen.
The Stash 1.3 team
Federico Silva Armas
Product Development Lead
Design and user experience