# Stash Latest (2.9) : Stash 2.8 release notes

Added by pwatson , edited by mwatson on Nov 05, 2013

1 October 2013

## Stash branching model

Stash 2.8 introduces a 'branching model' that provides key advantages for streamlining your Git development workflow:

- Developers can make consistent naming decisions when creating branches in Stash, guided by the naming conventions specified in the branching model.
- Reduce the need for manual maintenance of release branches, because consistent branch naming allows Stash to automatically cascade merges to those branch types.

Read more about the new branching model in Stash.

## Branch creation from within Stash

You can now create new branches in your Git repositories directly from the Stash web UI. When a branching model is configured, Stash guides you into making consistent choices for branch names:

Read more about creating branches in Stash.

## Branch creation from within JIRA and JIRA Agile

As part of our push to provide tighter integration between Stash and JIRA, you can now start creating a branch from within a JIRA issue, whether you are in JIRA or JIRA Agile. This gives you a faster workflow from picking an issue to starting coding:

Stash will suggest the branch type and branch name, based on the JIRA issue type and summary – you can change these, of course.

Your Admin needs to have set up linking with JIRA before you'll see this. Read more about creating branches from JIRA.

## Branch listing pages

To complement branch workflows, Stash now provides an overview of all branches in a repository. The Behind/Ahead information shows by how many commits a branch has diverged from the default branch (for example, `master`) for the repository, and can help you to identify work in progress as well as stale branches. The Actions menus provide branch tasks such as viewing the branches source files, creating a pull request, creating a new branch, and checking out the branch in Atlassian SourceTree.

Read more about the branches listing for a repository in Stash.

## Move Git repositories between Stash projects

You can now move a repository from one Stash project to another, if you have project administrator permissions for both projects.

To move a repository, go to Settings > Repository details for the repository you wish to move, and click Move repository:

## Improved integration with Atlassian SourceTree

You've been able to clone a repository from Stash using Atlassian SourceTree for a while. Now there are more ways that you can use Stash and SourceTree together, to help you use Git faster and more easily. Choose Check out in SourceTree from the Actions menu when you are:

- Viewing files or commits in a repository:
- Viewing branches in a repository:

## Small improvements

### Stash backup client is now production-ready

The Stash backup client introduced with Stash 2.7.0 is now supported for use in production environments. See Data recovery and backups.

### See the branches that a commit is visible on

When browsing a commit you can now see all the branches that the current commit is visible on. This makes it easier to determine if a particular change has been merged to the master branch, for example, or not:

### SSH support in the SCM Cache Plugin

The SCM Cache Plugin now supports SSH. This allows your CI build server to securely access the Stash server over SSH. See Scaling Stash for Continuous Integration performance for configuration information.

### Auto-expand directories with only one sub-directory

In the files listing for a repository, Stash will now automatically expand a directory that contains only one sub-directory. This can save time where there is a series of nested single directories – Stash will continue expanding directories until it finds two or more sub-directories.

## Change log

This section will contain information about the Stash 2.8 minor releases as they become available. These releases will be free to all customers with active Stash software maintenance.

If you are upgrading from an earlier version of Stash, please read the Stash upgrade guide.

The issues listed below are the highlights of all those that have been resolved for the Stash 2.8 releases.

### 5 November 2013 – Stash 2.8.3

Type | Key | Summary
--- | --- | ---
| STASH-3979 | Document move repository changes in 2.8 API changelog
| STASH-4026 | Switching branches in file view causes internal error with branch names containing a "/"
| STASH-4018 | Duplicate entries on the project list
| STASH-4000 | Occasional 500 errors from stash - NPE in XSRF token validation
| STASH-3997 | Branch permission patterns are case sensitive
| STASH-3991 | Stash dependency leaking into plugin dependencies
| STASH-3987 | Backups may be generated with out-of-date database data
| STASH-3986 | Stash REST API does not consistently provide a nextPageStart on paginated resources
| STASH-3977 | JIRA Feature Discovery behaves badly when switching tabs
| STASH-3914 | BranchSelectorField doesn't work when appended to an intermediate non-DOM element with jQuery
| STASH-3356 | Stash fails to connect to MySQL database if the user password contains special symbols
| STASH-3288 | UI broken after inactive user added to pull request
| STASH-3253 | Inconsistent behaviour for nextPageStart attribute on commits REST resource when specifying a since parameter
Authenticate to retrieve your issues

13 issues

### 15 October 2013 – Stash 2.8.2

Type | Key | Summary
--- | --- | ---
| STASH-3928 | Create users without setting a password via REST
| STASH-3906 | Developer documentation: Plugin example mistakes
| STASH-3973 | Hook callback sockets are not closed correctly
| STASH-3961 | Ref syncing raises RepositoryRefsChangedEvents with bad RefChanges
| STASH-3956 | Ref syncing fails when notes are pushed
| STASH-3952 | Ahead and behind information is not visible on the branch page anonymously
| STASH-3949 | Source view fails with "Resetting to invalid mark" on larger source files
| STASH-3947 | Searching nested group memberships fails for users with a large number of groups
| STASH-3945 | TrustedApplicationsAuthListener.authenticationFailure produces NullPointerExceptions
| STASH-3943 | ORA-01795: maximum number of expressions in a list is 1000
Authenticate to retrieve your issues

10 issues

### 2 October 2013 – Stash 2.8.1

Type | Key | Summary
--- | --- | ---
| STASH-3922 | Cannot set a reviewer when editing a pull request
Authenticate to retrieve your issues

1 issues

### 1 October 2013 – Stash 2.8.0

Type | Key | Summary
--- | --- | ---
| STASH-3561 | Create branch on Stash like on github
| STASH-3347 | Delete branch from UI
| STASH-3122 | API to hook into pull request merge process.
| STASH-2796 | Possibility to move a git repository from one project to another
| STASH-2691 | Display branches that particular commit is visible on
| STASH-3821 | REST /commits should default "until" to HEAD when specifying "since"
| STASH-3888 | Updating a trusted application fails with unique constraint violation on uk_trusted_app_restrict
| STASH-3881 | stash fails to display reviews/commits where commit message includes <U+2028>
| STASH-3875 | The default project permission is not getting cleared from the cache
| STASH-3819 | ExternalProcessImpl.areOutputPumpsRunning is not thread-safe
| STASH-3793 | git rev-list fails on startup
| STASH-3788 | Pull request events are not audited
| STASH-3777 | Stash cannot connect to other Atlassian applications on non-standard HTTPS port
| STASH-3748 | since and until parameters combined within REST API makes jira-key attribute go missing
| STASH-3204 | DataIntegrityViolationException when configuring Trusted Application
Authenticate to retrieve your issues

15 issues

## Attachments:

STASH28_branches.png (image/png)
STASH28_branches.png (image/png)
005.png (image/png)
STASH28_create_branch_in_JIRA.png (image/png)
STASH28_create_branch_action.png (image/png)
branching.png (image/png)
STASH28_branch_model.png (image/png)
STASH28_move_repo.png (image/png)
STASH28_branches_on_commit.png (image/png)
STASH28_files_sourcetree.png (image/png)
STASH28_commits_sourcetree.png (image/png)
STASH28_files_sourcetree.png (image/png)
STASH28_branches_sourcetree.png (image/png)
STASH28_branches_sourcetree.png (image/png)
STASH_actions7.gif (image/gif)
STASH28_create_branch_jira.png (image/png)