Improve docs site to have the same look and feel of the primary weave.works website

[mestadler]

Problem

Currently, our docs and weave.works sites do not have the same look and feel. We want to have a seamless user experience, where the user starts on the main site and then can dive 'deeper' into our docs, without noticing.

Solution

Through css or other methods provided by Docusaurus the same look and feel of the company main website. Current css is located here, https://github.com/weaveworks/weave-gitops/blob/main/website/src/css/custom.css

Bonus would be to add link back to the weave.works main site in the nav bar, and so that customers can work back towards the main site if needed.

[alfaris]

Which docs page is our main this https://www.weave.works/docs/ or this https://docs.gitops.weave.works/

and what's the difference

[mestadler]

It should be the first link, to the docs site. The second link should be removed once the company website (that covers the marketing of the product) is ready.

Martin Stadler

SVP Customer Experience

www.weave.works

On 04/09/2023 at 08:33, Ahmed Faris @.***> wrote:

Which docs page is our main this https://www.weave.works/docs/ or this https://docs.gitops.weave.works/

and what's the difference

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: @.***>

[alfaris]

Hello, @mestadler @MostafaMegahid @LappleApple

I've made our first iterations for enhancing and matching the docs with our website you could see the 3 options on the screenshots below

also you could see the full design on Figma through the following link https://www.figma.com/file/IVHnM9iyeFWpd11evtY8ux/Weave-GitOps?type=design&node-id=19485-1454&mode=design&t=yKYxQZWSStaMTJfZ-4

Let me know your feedback

[lasomethingsomething]

Overall looking good, thank you @alfaris. A few super-quick things:

• I get that GitOps Run is a "main feature" in that it's available across WGE/OSS, but it's not a main draw of WeGO overall.
• What's up with the wintry striped scarf? :)

[alfaris]

• I used the same content on the landing page right now (https://docs.gitops.weave.works/) but we can improve it and change whatever will add value to the user browsing this page
• The wintry striped scarf - I thought of something that will give personality to Weave as Example GitHub uses a character in the space or space items but also we can iterate on it to come up with better fictional representation

[mestadler]

I like the format of the last one the most, really nicely done. Professional, polished, worth the $200k to $750k annual subscription our customers pay for our product.

I like the isometric icons, we should collect these. Assuming MJ?

Note to Lauri, I think that's the Weave flying carpet 😊

On Thu, 7 Sept 2023, 12:15 pm Ahmed Faris, @.***> wrote:

• I used the same content on the landing page right now ( https://docs.gitops.weave.works/) but we can improve it and change whatever will add value to the user browsing this page
• The wintry striped scarf - I thought of something that will give personality to Weave as Example GitHub uses a character in the space or space items but also we can iterate on it to come up with better fictional representation

— Reply to this email directly, view it on GitHub https://github.com/weaveworks/weave-gitops/issues/3910#issuecomment-1709967840, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACBDNHMYHZ5FYZOT6BAOOUDXZGUG3ANCNFSM6AAAAAA3CUPICY . You are receiving this because you were mentioned.Message ID: @.***>

[alfaris]

💡 Extra note for FE Engineers the used font in Docs are "system-ui, -apple-system, "Segoe UI" but in our website are "proxima-nova, sans-serif, "Helvetica Neue", Helvetica, Arial, sans-serif"