[WIP] Site design refresh

[jasonlong]

🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧

Do not merge

This is a WIP branch with updated tooling and a refreshed site design.

🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧🚧

Project board

https://github.com/git/git-scm.com/projects/2

Heroku review app URL

https://git-scm-pr-1179.herokuapp.com

---

Changes

Structural

• Responsive layout
• Pro Git book added as top-level section

Front end

• Tachyons CSS w/ minimal customizations/additions
• System font stack
• SVG icons / logos
• Updated title tags w/ most specific info at the beginning (for easier scanning in tabs)

Performance

• Page weight (TODO)
• CSS stats (TODO)
• JS reduction (TODO)

A11y

• Improved color contrast
• aria-labels on buttons and permalink anchors.

Tooling

• TODO

Back end

• TODO

[connorshea]

Conflict markers are still here :)

[pedrorijo91]

@jasonlong free to pick this up again? how can we help? :)

[jasonlong]

@pedrorijo91 Sorry again for the lack of progress here. I keep shooting myself in the foot here since each time I finally find some time to spend on this project my dev setup is broken and by the time I've gotten things fixed up, I get really busy with work again.

I'm not sure how easy it would be, but maybe someone could help get this branch updated with all of the updates to master over the past few months? If there are conflicts that need my context, those can be left for me to check into.

[pedrorijo91]

totally understand @jasonlong 😅

If I remember correctly, there weren't any major changes recently. A few new books/GUIs, fixing the ES client, and some work on book translations.

will have a look during this week to help you :)

[pedrorijo91]

@jasonlong sorry for taking to much time, last week was chaotic. Started merging master into v2. Still halfway, but will look at it in a couple of hours to finish it still today

[prasadgujar]

#1188 this is resolved under this PR @jasonlong @pedrorijo91 @peff @rybak @connorshea ?

[peff]

@jasonlong There was discussion a few weeks at the last git contributors summit about setting up a community blog, that could be accessible at blog.git-scm.com or similar. Do you have any recommendations on styling to make it look consistent with the rest of the site? I.e., should people pull style elements from the existing site, or from this PR? Do you have an idea of whether you might pick this PR up again?

[jasonlong]

Hey @peff, I should be able to help with the blog styling. Is the plan to use a standalone site? I could extract the basic styling from the "new" design into something appropriate for the blog.

And yes, I still want to see this redesign through. I'm struggling to carve out time to be able to deeply get into it.

[peff]

@jasonlong Sorry for the slow reply. Yeah, the plan is to keep it standalone, to keep it away from the Rails complexity in the current site (and also it would probably have a larger set of people contributing to it). Right now there's a bare-bones Hugo setup at https://gitlab.com/git-scm/blog, but there are no posts yet.

[jamesramsay]

@jasonlong I'm working on trying to get a minimal version of the blog up and running linked by @peff. If you have a mockup of the new site you are working on, I could take that as inspiration so that there is a some similarity.

[pedrorijo91]

there used to be a live app with the new UI, but it seems there's an error deploying to heroku currently..

[olegKusov]

I have some ideas about git-scm.

1. New minimalistic and responsive design. I cant help with it.
2. New ideas with documentation. Git is not easy. And it will be cool if we add some interactive descriptions with live branch creation tool on web page. For example , user reads something about "git revert" and on the page he can create branches and play with them with some little lessons from git-scm. I think it will be cool. Know git-scm is just hard readable documentation. And that's why we have a lot of blogs about git. We need to make official documentation easy for noobs.

[felipec]

Is there any link to see this redesign in action?

[pedrorijo91]

closing as it's stale for a long time

[vitaly-zdanevich]

So, no new design with dark theme? :(