message: Adds remarks to 'spo theme set' docs. Closes
diff: @@ -24,6 +24,46 @@ m365 spo theme set [options]
  !!! important
  To use this command you have to have permissions to access the tenant admin site.
  +## Remarks
  +
  +To prevent the accidental creation of invalid themes the CLI for Microsoft 365 implements a set of checks. These checks are executed against the provided json file. A valid theme JSON file is as follows:
  +
  +```json
  +{
  + "themePrimary": "#d81e05",
  + "themeLighterAlt": "#fdf5f4",
  + "themeLighter": "#f9d6d2",
  + "themeLight": "#f4b4ac",
  + "themeTertiary": "#e87060",
  + "themeSecondary": "#dd351e",
  + "themeDarkAlt": "#c31a04",
  + "themeDark": "#a51603",
  + "themeDarker": "#791002",
  + "neutralLighterAlt": "#eeeeee",
  + "neutralLighter": "#f5f5f5",
  + "neutralLight": "#e1e1e1",
  + "neutralQuaternaryAlt": "#d1d1d1",
  + "neutralQuaternary": "#c8c8c8",
  + "neutralTertiaryAlt": "#c0c0c0",
  + "neutralTertiary": "#c2c2c2",
  + "neutralSecondary": "#858585",
  + "neutralPrimaryAlt": "#4b4b4b",
  + "neutralPrimary": "#333333",
  + "neutralDark": "#272727",
  + "black": "#1d1d1d",
  + "white": "#f5f5f5"
  +}
  +```
  +
  +When executing the `m365 spo theme set` command the following checks are executed:
  +
  +- Validate if the provided file is a valid `JSON` string.
  +- Validate if the provided file, once deserialized, contains all properties of the sample above.
  +- Validate if the provided file, once deserialized, contains only the properties of the sample above.
  +- Validate if each of the properties contains a valid hex color value prefixed with a `#`.
  +
  +If any of these checks fails you are presented with a `File contents is not a valid theme` error.
  +
  ## Examples
  Add or update a theme from a theme JSON file
  @@ -40,5 +80,5 @@ m365 spo theme set -n Contoso-Blue -p /Users/rjesh/themes/contoso-blue.json --is
  ## More information
  -- SharePoint site theming: [https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)
  +- SharePoint site theming: [https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview](https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-theming/sharepoint-site-theming-overview)
  - Theme Generator: [https://aka.ms/themedesigner](https://aka.ms/themedesigner)
  