Repository-design-updates.md

Repository design updates

We've updated the repository pages to be respoinsive, and made some layout changes to the Code tab. We've added a sidebar to elevate project information that previously has been a hidden behind clicks, and given more space to features that support the development workflow.

To enable this new design you can switch it on via Feature Preview, and if you have any issues you can diable it again too.

Profile dropdown > Feature Preview > Repository design updates > Click "Enable"

Open Feature Preview	Enable Repository design updates

We want to make sure these updates work for maintainers, and would really appreciate feedback on things like:

• UX and visual bugs
• Performance issues
• Confusing designs or navigation
• Anything that feels like a disruptive change
• Things you wish were different
• Things you love about it 💓

Please let us know what you think by sending feedback here.

As noted in the screenshots at the bottom, which contrast the new Repository refresh feature, several observations come to mind.

tldr;

Overall, I prefer the old design which adhered to the laws of simplicity and constrained the visual display of data in a way that was concise and easily accessible. The previous presentation needed to be tweaked in my opinion rather than overhauled in such a disruptive way. Changes should be fewer or at least less enforced for users who may be overly sensitive and responsive to color and focus. A sidebar in this case may not serve the intent to provide a strong focal point when viewing a repository.

Background considerations:

Why are we making changes? Do the changes improve usage, and if so in what way? Are we adding functionality? The existing design was well-thought out and had very subtle effects that assisted developers in being productive. Colors, lines, typography, and prose all permeated the design to enable developers to instantly understand what we are looking at when viewing a repository. Change should be made cautiously in this case unless the disruption is warranted by some perceived benefit.

Given these considerations here is my feedback:

• Removal of the metadata from above the files makes the information less concise and less efficient
• An alternative to the removal of the metadata is to add more hover over features (as seen in hovering over contributors)
• The new sidebar panel is missing a toggle to allow readers to expand/collapse it
  (since this is the most disruptive feature it should be something readers can toggle as a preference)
• When expanded the new sidebar panel makes consuming information harder by increasing volume of the design
• The New pull request button is removed from the front page and adds additional steps to one of the most used features
• Changes to the styles (colors, shading) make it harder to distinguish between the documented code, information, and actions
  (the styling above the file between the main code page and when viewing files is inconsistent and jarring)
• Color considerations (the orange styling served a distinct purpose and was very useful to bring attention to the metadata)
• Spreading metadata over a larger area does not make finding the information easier

Thats cool

Very good, thank you 👋🏼

Cool! Great work!

Good idea but I would appreciate some tweaks like switching sidebar from right to left, or just hide it altogether.

Did you mean "you can disable it again too" instead of "you can diable it again too"?

Just to answer some of the comments regarding the sidebar's position. For me somehow the right-aligned sidebar makes a lot of sense on GH and it just feels wrong for it to be on the left.

I also think it looks better than on the right

Just to answer some of the comments regarding the sidebar's position. For me somehow the right-aligned sidebar makes a lot of sense on GH and it just feels wrong for it to be on the left.

Just to answer some of the comments regarding the sidebar's position. For me somehow the right-aligned sidebar makes a lot of sense on GH if you have some useful extension.

Repository main page become so asymmetric... Can it be somehow adjusted?

I really like the design of new buttons ("clone", "new issue", etc). Are those still bootstrap buttons that have been redesigned by you or it's new framework?