[IMP] scss: update, improve preexisting content

Add a new content focused on SCSS and user-interface.

- SCSS coding guidelines: regroup information already available (eg [1])
  or based on "oral tradition".
  The aim is not to establish new rules, ~99% of the current codebase
  is already compliant.

- SCSS inheritance: explain how SCSS assets management works in odoo.
  For example, people still find confusing that overrides are defined
  *before* the variable to customize.

- SCSS optimization tips: suggestions to lean SCSS code. Based on SCSS
  optimization task's know-how [2].

- CSS variables: explain how this feature is commonly used in odoo to
  adapt layout & design without raw CSS overrides.

- UI Icons: Add link to fontAwesome4 library . Replace the picture of
  odoo icons with the actual font (90kb image VS 15Kb font)

[1] https://github.com/odoo/odoo/wiki/SCSS-coding-guidelines
[2] https://www.odoo.com/web#id=2704984&menu_id=4720&cids=1&model=project.task&view_type=form

task-3090800

closes odoo/documentation#3093

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>

This commit is contained in:

stefanorigano (SRI)

2022-10-27 08:19:25 +00:00

committed by

Antoine Vandevenne (anv)

parent 42f6840586

commit 2ca32b40bc

17 changed files with 1094 additions and 17 deletions

									
										content/developer/reference.rst
									
		+1
		
												View File
												
				@@ -9,4 +9,5 @@ Reference

				    reference/backend

				    reference/frontend

				    reference/user_interface

				    reference/standard_modules