documentation/content/contributing
stefanorigano (SRI) 2ca32b40bc [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>
2023-01-12 18:19:27 +01:00
..
development [IMP] scss: update, improve preexisting content 2023-01-12 18:19:27 +01:00
documentation [IMP] contributing/documentation: rewrite the contribution guide 2023-01-03 13:27:06 +01:00
check_mergeability_status.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00
configure_git_authorship.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00
configure_github_account.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00
create_github_account.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00
development.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00
documentation.rst [IMP] contributing/documentation: rewrite the contribution guide 2023-01-03 13:27:06 +01:00
handle_reviews.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00
install_git.rst [ADD] contributing/development: add a guide to contribute to the codebase 2023-01-03 13:27:05 +01:00