openstax / cnx-recipes

The extended CSS recipes for cooking openstax books

https://packages.cnx.org/cnx-rulesets/latest/

GNU Lesser General Public License v2.1

5 stars 14 forks source link

Main Epic for Baked Styles Refactoring #4584

Open lwtchu opened 2 years ago

lwtchu commented 2 years ago

General Rules

https://docs.google.com/document/d/15CNiQQDEDo9M49IFkjhc9bTkzMZ6b1PXeEZ5J7LeQwI/edit#heading=h.780lrpfdmrah

Spreadsheet

https://docs.google.com/spreadsheets/d/18SoSMPVri-FEzBj9-EwBwICFw9wMtTFIVYile5UQ3xU/edit#gid=901187228

Testing Guidelines

Upcoming books that we are publishing are Precalculo 2ed (Spanish Precalculus), Philosophy and Political Science. If the issues you are working on impact the three titles listed above, please merge at the latest, the Wednesday morning (US time) before code freeze so Alan and Marta have ample time to test these titles
For all other issues, please wait until the big issue goes through.
Check 3 books per theme impacted, spot check a few of the features and if there are no changes, it should be okay.
Note: If there are padding changes, please let Larissa know the new page count so we can see if it's gotten worse
Once a few cards go through, we can use the PDF comparison tester to test PDFs

openstaxalina commented 1 month ago

Notes for myself

less complex components are done - this is noted in green on the spreadsheet
more complex components still need to be done
this is focused on cleaning up the themes in baked styles (tech debt from initial baked styles rollout)
a more general framework refactor is described here: https://github.com/kswanson33/styles-framework-comparison