feat: rebranding docs

[tblivet]

Questions	Answers
Branch?	9.x
Description?	Docs for BO rebranding
Fixed ticket?

[kpodemski]

Hello @tblivet @jolelievre

Part of this content looks like it should be shared on the Build Blog, and another part looks like something we should put in "Notable changes" in the documentation, some is a generic information about CSS variables and something that could be part of the PrestaShop UI Kit repo only. I see three items:

First

Files:

• development/rebranding/themes.md
• development/rebranding/ui-kit-v2/why.md
• development/rebranding/ui-kit-v2/css-variables.md

are good material for an article on the build blog or to the "second" point on this list.

Second

Files:

• development/rebranding/ui-kit-v2/variables-reference.md
• development/rebranding/ui-kit-v2/how-to-use-it.md
• development/rebranding/ui-kit-v2/css-variables.md

are good content for https://devdocs.prestashop-project.org/8/development/uikit/

Third

Files:

• development/rebranding/introduction.md
• development/rebranding/breaking-changes.md

Something that should go to the Notable Changes.

Let me know what you think. I'm not insisting on having an article on the build blog, but "Why" and "How we did it" should be inside UI Kit section and linked from the Notable changes :)

[kpodemski]

no need to load mermaid if you don't use mermaid 😎

[tblivet]

Hi @kpodemski and @jolelievre,
Based on your comments and other feedback, I have made some changes to make the documentation less narrative and more technical. I will include more narrative content in a separate blog post, as you suggested. I agree, it's a good idea to provide information in a post.

[kpodemski]

Here's the review. I added some suggestions.

[kpodemski]

You can put this content inside the Notable Changes page that already exists:
https://devdocs.prestashop-project.org/9/modules/core-updates/9.0/

You can create a new section, "Back office rebranding", at the end of this page.

[kpodemski]

This content should be part of the existing notable changes page.

[kpodemski]

Not needed page.

[kpodemski]

I think you need to leave this page and create an alias, so that the old page will point to the new page.

[kpodemski]

Suggested change

	# Introducing CSS variables
	# CSS variables in PrestaShop UI Kit

[kpodemski]

Suggested change

	title: How to use it ?
	title: How to use it?

[kpodemski]

Suggested change

	To maintain consistency across the PrestaShop back office, CSS variables have been introduced in `_root.scss`. This guide explains how to use these variables in PrestaShop.
	To maintain consistency across the PrestaShop back office, CSS variables have been introduced in `_root.scss`. This guide explains how to use them.

[kpodemski]

Suggested change

	## Using CSS variables with v9 and higher
	## Using CSS variables in PrestaShop 9.0+

[kpodemski]

Suggested change

	In PrestaShop v9 and higher, use the CSS variables introduced in `_root.scss` for consistent styling in the Back Office.
	In PrestaShop v9 and later, we use the CSS variables introduced in `_root.scss` for consistent styling in the back office.

[kpodemski]

Here I think you should use refrel to the docs page you created, right?

[tblivet]

Hi @kpodemski, I have just added your suggestions. Is it okay for you?

[kpodemski]

love it, thank you @tblivet !

[matks]

Thank you @tblivet 😄