Skip to content

adds updates to HTML, CSS, JS, guidelines

Stu Robson requested to merge dev/guidelines into develop

This is a first pass. It includes pages on:

  • the CSS naming convention.
  • how to write some CSS.
  • what the purpose of the JS in the patterns is
  • how to author HTML

Things I know I want to take another look at:

  • CSS order: as we are using grid and flexbox for layout it feels like alphabetical is a little antiquated as we would are writing CSS for the component and the components children in the same ruleset.

  • CSS custom properties: How do we include these, how do we make sure older browsers still get something.

  • Browser support documentation: I guess we can borrow this from current VF?

  • Universal Components: how we should be writing code for everyone, including screen readers. Where to add aria things etc.

  • JavaScript: although the docs essentially say "don't use this" we need to work how we are going to write JS for any component that needs it and how we should be writing that.

#changelog #updates

Edited by Stu Robson

Merge request reports