Merged in chore/update-readmes (pull request #2751)

chore: Update README

* Update readme


Approved-by: Chuma Mcphoy (We Ahead)
Approved-by: Joakim Jäderberg

docs/icons.md

@@ -0,0 +1,25 @@
+# Material Symbols
+
+We download the font file from Google Fonts service and host it ourselves.
+
+## Configuration
+
+We use the following configuration:
+
+- FILL axis: 0..1
+- wght axis: 400
+- GRAD axis: 0
+- opsz axis: 24
+
+More info at https://developers.google.com/fonts/docs/material_symbols#optimize_the_icon_font
+
+## Optimization
+
+We optimize the font size by only including the icons we use in the repository.
+
+Read more at: https://developers.google.com/fonts/docs/material_symbols#use_in_web
+
+## Modifying icons
+
+1. Update the list of icons to include in `scripts/material-symbols-update.mjs`.
+2. Run `yarn run icons:update` in monorepo root.