Update README for 1.2

Author: idan

README.md

@@ -13,10 +13,11 @@ Letters on a grid is how we see our code. Why not make those letters better?
 
 ## Overview
 
-Monaspace is available as a variable-axis font and a static build. You can install them both side-by-side; their family names are distinct. For example:
+Monaspace is available in three distinct variations. You can install them both side-by-side; their family names are distinct. For example:
 
-- `Monaspace _____`: the static family
+- `Monaspace _____`: the static family.
 - `Monaspace _____ Var` or `VF`: the variable family
+- `Monaspace _____ Frozen`: the "frozen" TTF family. These fonts enable all of the typographical features in Monaspace by default. They are intended to be used in environments where you might not be able to configure stylistic sets or character variants, like XCode or IntelliJ IDEs. See more about how the frozen fonts work below.
 
 The variable fonts have one file per family (Neon, Argon, etc.). Modern and convenient!
 
@@ -32,10 +33,27 @@ Texture healing is enabled when the `calt` font feature setting is turned on in
 
 You can read more about how it works on the [Monaspace website](http://monaspace.githubnext.com), and learn how it is implemented in the [documentation](https://github.com/githubnext/monaspace/blob/main/docs/Texture%20Healing.md).
 
+## Nerd Fonts
+
+As of Monaspace 1.2, the static font builds (both OTF and WOFF/WOFF2) include [Nerd Fonts](https://www.nerdfonts.com/)!
+
+Monaspace gives a lot of consideration to horizontal and vertical metrics of a font, and Nerd Fonts are thousands of icons which don't necessarily respect those considerations. Monaspace makes a best-effort attempt to optically align the size and placement of the icons so that they feel compatible with the other Monaspace glyphs.
+
+There is such a broad variety of environments and terminals and often solving for one breaks another! Some Nerd Fonts glyphs may not render correctly in every environment.
+
+> [!NOTE]
+> Monaspace uses the [Nerd Fonts implementation from Cascadia Code](https://github.com/microsoft/cascadia-code/tree/main/sources/nerdfonts/full/processed) as our starting point. Each icon was resized to fit the max advance width of the given Monaspace font, and centered vertically between the baseline and cap height of Monaspace's vertical metrics.
+
+
 ## Coding Ligatures
 
 > [!WARNING]
-> Ligature handling has changed significantly in Monaspace v1.1 and v1.101. If you're upgrading, see the [release notes for guidance on how to alter your editor settings](https://github.com/githubnext/monaspace/releases/tag/v1.100).
+> Ligature handling has changed significantly in Monaspace point releases.
+> If you're upgrading, check the release notes to learn what changes you might need to make to your editor configuration:
+> - [v1.1](https://github.com/githubnext/monaspace/releases/tag/v1.100)
+> - [v1.101](https://github.com/githubnext/monaspace/releases/tag/v1.101)
+> - [v1.2](https://github.com/githubnext/monaspace/releases/tag/v1.200)
+
 
 The `liga` font feature enables customized spacing of repeating characters, like `///` or `||`. It is designed to avoid activating inside longer sequences like `////`.
 
@@ -55,12 +73,39 @@ There are eight groups of coding ligatures, separated into stylistic sets. You m
 
 ## Character Variants
 
-Specific characters have variants that you can optionally enable:
+Specific characters have variants that you can optionally enable using the `cvNN` opentype feature:
+
+#### cv01-cv09: figure variants
+- `cv01`: `0` alternates
+  - 1: plain
+  - 2: slash
+  - 3: reverse slash
+  - 4: cut-out slash
+- `cv02`: `1` alternate (no serif)
+
+#### cv10-cv29: letter variants
+- `cv10`: `l` `i` alternates (Neon, Argon, Xenon, Radon)
+- `cv11`: `j` `f` `r` `t` alternates (Neon, Argon)
 
-* `cv30`: Enable the older asterisk as shipped in Monaspace 1.0, which was vertically aligned closer to the top of the space.
-* `cv60`: forces the `<=` pair to render in a fashion that matches `=>` instead of swapping for `≤`.
-* `cv61`: enables the optional closed square ligature for `[]`. This can be distracting when authoring arrays in many editors, because they automatically insert the closing bracket, which immediately produces the closed square ligature upon typing the open bracket.
+#### cv30-cv59: symbol variants
+- `cv30`: `*` vertically aligned closer to the top of the space, similar to how the asterisk was in Monaspace 1.0
+- `cv31`: `*` 6-pointed asterisk
+- `cv32`: `≥` `≤` angled lower line
 
+#### cv60-cv79: optional ligatures
+- `cv60`: forces the `<=` pair to render in a fashion that matches `=>` instead of swapping for `≤`.
+- `cv61`: enables the optional closed square ligature for `[]`. This can be distracting when authoring arrays in many editors, because they automatically insert the closing bracket, which immediately produces the closed square ligature upon typing the open bracket.
+- `cv62`: `@_` ligature
+
+
+### cv80-cv99: reserved for future use
+- none (yet!)
+
+## Special Characters Galore
+
+In addition to the ligatures, character variants, and Nerd Fonts, Monaspace includes a wealth of characters.
+
+![Special Characters](https://github.com/user-attachments/assets/c925585b-db09-45e2-ac75-911e89419a47)
 
 ## Desktop Installation
 
@@ -108,12 +153,18 @@ All files with a `.woff` or `.woff2` suffix are intended for use on the web. You
 
 As with the desktop fonts, they are available in variable and static versions.
 
+There are no "frozen" webfonts. You can control Opentype features on the web using the [`font-feature-settings`](https://developer.mozilla.org/en-US/docs/Web/CSS/font-feature-settings) CSS property.
+
 ## Editors
 
 ### Visual Studio Code
 
 > [!WARNING]
-> Ligature handling has changed significantly in Monaspace v1.1. If you're upgrading from Monaspace v1.0, see the release notes ([v1.100](https://github.com/githubnext/monaspace/releases/tag/v1.100), [v1.101](https://github.com/githubnext/monaspace/releases/tag/v1.101)) for guidance on how to alter your editor settings.
+> Ligature handling has changed significantly in Monaspace point releases.
+> If you're upgrading, check the release notes to learn what changes you might need to make to your editor configuration:
+> - [v1.1](https://github.com/githubnext/monaspace/releases/tag/v1.100)
+> - [v1.101](https://github.com/githubnext/monaspace/releases/tag/v1.101)
+> - [v1.2](https://github.com/githubnext/monaspace/releases/tag/v1.200)
 
 Set the font family:
 
@@ -136,9 +187,16 @@ You must use the `editor.fontLigatures` setting to enable the various features (
 
 Putting it all together, a setting string which enables everything but the character variants would look like this:
 ```json
-  "editor.fontLigatures": "'calt', 'liga', 'ss01', 'ss02', 'ss03', 'ss04', 'ss05', 'ss06', 'ss07', 'ss08', 'ss09'",
+  "editor.fontLigatures": "'calt', 'liga', 'ss01', 'ss02', 'ss03', 'ss04', 'ss05', 'ss06', 'ss07', 'ss08', 'ss09'"
 ```
 
+Specific character variants are also enabled using the [`font-feature-settings`](https://developer.mozilla.org/en-US/docs/Web/CSS/font-feature-settings) syntax. To enable slashed zeroes (with `cv01`) and six-pointed asterisks (with `cv31`), you might use the following settings:
+```json
+  "editor.fontLigatures": "'calt', 'liga', 'ss01', 'cv01' 2, 'cv31' 1"
+```
+
+Note that some character variants have several possible values. For any variants that are either on or off, setting them to `1` should enable them, and omitting the variant (or setting them to `0`) will disable them.
+
 ## Contribution
 
 There's no formal contribution guide yet! If you're interested in contributing to the typefaces, you should read the [Texture Healing](https://github.com/githubnext/monaspace/blob/main/docs/Texture%20Healing.md) guide, as it explains how to produce the necessary alternate glyphs.