[not ready] Docs updates

about to ping a bunch of people about TODOs here, be ready
Should we assume this is CSS-y enough to not need a description, or provide one?