Standardize formatting and styles

Put installation options for each operating system into tabs

Author: stevepiercy

docs/classic-ui/whatsnew.md

@@ -11,12 +11,12 @@ myst:
 
 # What's new in Plone 6 Classic UI
 
-- HTML markup is now based on [Twitter Bootstrap 5](https://getbootstrap.com/).
-- Twitter Bootstrap 5 icons are now included.
-- Bootstrap JavaScript is available by default.
-- JavaScript has been modernized.
-- RequireJS has been removed.
-- Module Federation support for add-ons.
-- jQuery has been updated.
-- The TTW theming editor has been removed.
-  Through-the-web theming is limited to downloading and uploading themes.
+-   HTML markup is now based on [Twitter Bootstrap 5](https://getbootstrap.com/).
+-   Twitter Bootstrap 5 icons are now included.
+-   Bootstrap JavaScript is available by default.
+-   JavaScript has been modernized.
+-   RequireJS has been removed.
+-   Module Federation support for add-ons.
+-   jQuery has been updated.
+-   The TTW theming editor has been removed.
+    Through-the-web theming is limited to downloading and uploading themes.

docs/contributing/setup-build.md

@@ -9,7 +9,7 @@ myst:
 
 (setup-build-label)=
 
-# Building and Checking the Quality of Documentation
+# Building and checking the quality of documentation
 
 This document covers how to build the Plone Documentation and check it for quality.
 
@@ -48,25 +48,25 @@ This is an easy way to become a contributor to Plone.
 ```
 
 
-```{note}
-If you are using an M1 Mac to build the documentation, there is currently [an issue with pyenchant](https://github.com/pyenchant/pyenchant/issues/265) that throws an error that the enchant library can't be found.
-This happens for example if you install Python 3 with `pyenv` in the default M1 architecture (aarch64), so without following instructions to use Rosetta2 x86 emulation.
-A workaround until pyenchant is fixed is to run `export PYENCHANT_LIBRARY_PATH=/opt/homebrew/lib/libenchant-2.dylib` in the terminal session before you execute `make html`.
-```
+(setup-build-installation-graphviz-label)=
 
-Install [Graphviz](https://graphviz.org/download/) for graph visualization.
+### Graphviz
 
-**macOS**
+Install [Graphviz](https://graphviz.org/download/) for graph visualization.
 
+`````{tab-set}
+````{tab-item} macOS
 ```shell
 brew install graphviz
 ```
+````
 
-**Ubuntu**
-
+````{tab-item} Ubuntu
 ```shell
 sudo apt-get install graphviz
 ```
+````
+`````
 
 
 (setup-build-installation-clone-plone-documentation-label)=

docs/glossary.md

@@ -511,22 +511,24 @@ Zope Component Architecture
     The ZCA is not specific to the Zope web application server.
     It can be used for developing any Python application.
     Maybe it should be called Python Component Architecture.
-    For more info read: https://muthukadan.net/docs/zca.html
+    ```{seealso}
+    See also https://muthukadan.net/docs/zca.html.
+    ```
 
 browser layer
 Layer
-    A layer, or also called browser layer, is a marker interface and used in ZCML configurations.
+    A layer—also called "browser layer"—is a marker interface and used in ZCML configurations.
     Layers allow you to enable and disable views and other site functionality based on installed add-ons and themes.
 
 JSON
-    JSON (JavaScript Object Notation, pronounced /ˈdʒeɪsən/; also /ˈdʒeɪˌsɒn/) is an open standard file format and data interchange format that uses human-readable text to store and transmit data objects consisting of attribute–value pairs and arrays (or other serializable values).
+    JSON (JavaScript Object Notation, pronounced /ˈdʒeɪsən/; also /ˈdʒeɪˌsɒn/) is an open standard file format and data interchange format that uses human-readable text to store and transmit data objects consisting of attribute-value pairs and arrays (or other serializable values).
 
     ```{seealso}
     See also https://en.wikipedia.org/wiki/JSON.
     ```
 
-HTTPRequest
-    The HTTPRequest object contains information about the current request, which also includes browser layers.
+`HTTPRequest`
+    The `HTTPRequest` object contains information about the current request, which also includes browser layers.
 
 interface
     An interface is a mechanism for labeling objects as conforming to a given API or contract.