Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Introducing: A new Bitbucket pull request experience

This feature update was also published on the Bitbucket blog.

Here at Bitbucket Cloud, we are focused on helping you and your teams have the best possible experience for code review. That’s why we continue to add features like batched comments, marking files as viewed, AI-assisted pull request descriptions – and coming very soon, iterative reviews.

We also want to give you the best possible experience navigating a pull request, which is why we’re proud to be introducing a brand-new layout for pull requests. It’s available for you to try as of today, and over the coming weeks we’ll be rolling it out to all of our users.

bitbucket-new-pull-request-overview.png

What’s new in the design?

The pull request page is the place in Bitbucket where your most critical work gets done, and we’ve consistently heard a couple areas of feedback that we wanted to address

  • It can be difficult to understand what’s changed recently, which is critical when you’re returning to a pull request you’ve already viewed.
  • Navigating PRs with a large number of files can be challenging with the existing sidebar file tree.

That’s why we’ve moved to a tabular design that puts recent activity front and center, as well as providing a dedicated diff tab for full-screen code review. This design was heavily influenced by our sister product Bitbucket Data Center, so those of you who have used BBDC will find our new layout particularly familiar.

Rich activity feed

Right away, you’ll notice that we’ve moved the activity feed from the right sidebar to its own prominent space on the Overview tab. Here you’ll find all the latest updates on the pull request – comments, approvals, new commits – in an easy-to-read format.

We’ve given particular attention to comment threads, which now include the context of code changes that they apply to. You can also reply to, resolve, and create tasks from comments right on the activity feed. And, when you need to, you can jump from a comment thread straight into the diff.

bitbucket-new-pull-request-activity-feed.png

Focused code review

The Files changed tab provides a dedicated space for you to dive into code review. We’ve moved the file tree from the sidebar to the left of the page, a more natural location. If you like, you can fully collapse the file tree and side navigation for full-screen code review.

bitbucket-new-pull-request-diff.png

This new design for the diff includes all the viewing options you’re used to, like side-by-side code review, hiding whitespace changes, and loading files individually so you can focus on one file at a time.

We think this new diff view works particularly well in single-file mode. To switch this on, go to the Files changed tab, select the cog icon, and then choose the option to load files individually.

bitbucket-new-pull-request-settings.png

Available today

Starting May 13, we’ve made the new layout available to all Bitbucket Cloud users on an opt-in basis. If you’d like to be one of the first to try it, visit Labs in your Bitbucket settings, then switch on the New pull request experience feature.

bitbucket-new-pull-request-labs.png

In the coming weeks we’ll be gradually rolling out the new experience to users, so you can also just wait and you’ll see it automatically. We know it can take time to adjust to a new layout, so as we’re rolling out the feature, you will have the option to temporarily change back to the old view.

Starting June 10, the new layout will be fully rolled out, and we’ll permanently retire the old view.

We’d love your feedback

Here at Atlassian, our teams have already been seeing the benefits of working with this more streamlined view of pull requests. And while we are confident that your teams will have this same experience with the new layout, we would love to hear from you after you’ve had a chance to try it.

If you have any feedback whatsoever – or if you’ve found a bug – please head to the Bitbucket help menu > “Give feedback” to share your thoughts with us.

6 comments

Ulrich Kuhnhardt _IzymesCo_
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
May 13, 2024

Hi @Dave Parrish _Atlassian_ 

looks great. Love the new UI.

I must have missed the RFC for this update. In case there wasn't an RFC, we would appreciate if you could add a section for BBCloud RFCs so we can give feedback early - in the 'impossible alone' spirit.

1. I personally find the comment UX a little noisy with duplication that could be simplified IMHO

bbcloud feedback.png

2. Are there any new UI component plugin points (ACE or Forge) on the new PR view page? I could think of additional tabs ... which would be an absolute dream for app developers.

app tab.png

 

Thanks again for the great work on the PR page UI. Let me know if you need further details or please reach out any time.

Best, Ulrich

// Izymes

Like # people like this
Michael Rüegg _Mibex Software_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
May 14, 2024

I agree with @Ulrich Kuhnhardt _IzymesCo_ .

I like the redesign, but also think that app extensibility should be an important matter to consider when doing it. For that, an RFC would be welcome to discuss the viewpoint of the community that builds extensions for it.

Regarding extensions:

1. A way to add new tabs on the PR page for Forge apps would indeed be very appreciated.

2. Additionally, a way to add actions to the top-right context menu is important to migrate apps from Bitbucket DC, because there this is possible and used heavily by our apps.

3. Off topic: on the PR create page, there is no way to hook into the UI for apps. IMHO, that is important for Forge app adoption as well.

 

Like # people like this
Dave Parrish _Atlassian_
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
May 17, 2024

Hi @Ulrich Kuhnhardt _IzymesCo_ and @Michael Rüegg _Mibex Software_ 👋 thanks so much for the feedback.

Now that we have the new layout in customers' hands, we are actively exploring options for extensibility, including all of the ones you mention. We will definitely share our early thoughts with the developer community.

Like # people like this
Ulrich Kuhnhardt _IzymesCo_
Marketplace Partner
Marketplace Partners provide apps and integrations available on the Atlassian Marketplace that extend the power of Atlassian products.
May 20, 2024

@Dave Parrish _Atlassian_ are you considering adding extension points to PR create page, as @Michael Rüegg _Mibex Software_ suggested?

Ian Hunter May 21, 2024

I know there are always naysayers and someone is always going to complain about every change, but I've tried the new "experience" and it's truly upsetting.  What was wrong with having everything relevant to the PR co-located on the same view?

> Right away, you’ll notice that we’ve moved the activity feed from the right sidebar to its own prominent space on the Overview tab.

It's not prominent, it's hidden away on a tab that I don't want to have to switch to - the diff is what's relevant, and I used to be able to see the activity, and the tasks, and the merge checks, and everything else without leaving the diff.  Adding extra clicks and scrolling and browser requests and load times and manually searching to get back to what I was looking at on the other tab has not improved my experience; quite the opposite!

> We’ve given particular attention to comment threads, which now include the context of code changes that they apply to.

I don't know if it's bugged at the moment, but there most definitely is not context of the code in the activity list on my PRs with the lab enabled.  Even if there was, how do you presume to know how many lines of context are actually required to understand the comment?

Imagine you manufactured cars, and someone thought it was a good design to make a car where you could either have access to the front windscreen and the steering wheel, or the brake pedal and the instrument cluster, but not all at the same time.  And when you switch back to the steering wheel, it has reset itself to the initial position.  But don't worry, the instrument cluster is in a new prominent space, on the floor between your feet, and while you're looking down there there's a little LED screen to show you the context of where you are on the road, but only 2 feet in front of you and behind you.  I can imagine Atlassian Auto greenlighting that design...

Like # people like this
Michał Fastyn May 21, 2024

Bravo @Ian Hunter 
This "new new" experience (yes, we had one new experience not so long ago) is a "clickfest" and "scrollfest"

  • Who thinks that going to activity tab first instead of code is good idea?
  • Why during review I can't see PR description where we f.e. put screenshot of what has changed. Now I can't read code and see screenshot at the same time. How does this help me?
  • And going back & forth is horrible! I cant change tab when I'm half way through review because this will mean my view will be reset. Happy scrolling back where you was!
  • When you comment on whole PR just after you create it (using comment under description) guess where this comment will be after few comments to code. Yep. On the deep bottom of "overview" somewhere down there where no one will ever see it. Before changes this comments were stick to the PR top where anyone could see it, always. Now this will be worth nothing on the bottom of overview. 

This is sooo frustrating. Last time you did "new" experience you removed quite a lot of features that were available earlier and we waited months to get them back. You always do it like that. "We have this new cool stuff for you! But...". There is always hidden "But".

After years of using BB this is next example from atlassian that you always try to fix something by creating new sets of problems or by removing features.

There are like tones of requests to give us simple features that would make our life easier. They are floating there for YEARS with hundreds of "+1".
Examples? Resolvable comments (2013),  making files as viewed, code coloring. This are NOT your ideas but community requested features hanging for YEARS that you at last were kind enough to implement.

Couldn't you put this effort for making this everyday things we really need like GIT hooks or anything from this list instead of giving us next "new experience" that we will have to get use to?

With regards.

 

Like # people like this

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events