[STYLE] Documentation style fixes for the FAQ updates (- WIP PR #429 -)

Changes in file docs/FAQ.md:
 * style fixes
 * multiple minor rewordings
 * added list of some key project policies for contributors

Changes in file docs/USAGE.md:
 * style fixes
 * simplified some code examples even more

Author: reactive-firewall

docs/FAQ.md

@@ -4,21 +4,30 @@
 
 ```{toctree}
 :maxdepth: 3
-:Name: Frequently Asked Questions
-
-[Code of Conduct](https://github.com/reactive-firewall/multicast/tree/HEAD/.github/CODE_OF_CONDUCT.md)
-[Contributing](https://github.com/reactive-firewall/multicast/tree/HEAD/.github/CONTRIBUTING.md)
+:caption: Frequently Asked Questions
 ```
 
+### Where can I find project policies and conventions?
+
+* [LICENSE](https://github.com/reactive-firewall/multicast/tree/HEAD/LICENSE.md)
+* [Code of Conduct](https://github.com/reactive-firewall/multicast/tree/HEAD/.github/CODE_OF_CONDUCT.md)
+* [Contributing](https://github.com/reactive-firewall/multicast/tree/HEAD/.github/CONTRIBUTING.md)
+  * [AI Usage Policy](https://github.com/reactive-firewall/multicast/tree/HEAD/.github/AI_USAGE_POLICY.md)
+  * [Convention Enhancement Proposal No. 4](https://gist.github.com/reactive-firewall/cc041f10aad1d43a5ef15f50a6bbd5a5)
+  * [Convention Enhancement Proposal No. 7](https://gist.github.com/reactive-firewall/123b8a45f1bdeb064079e0524a29ec20)
+  * [Convention Enhancement Proposal No. 8](https://gist.github.com/reactive-firewall/b7ee98df9e636a51806e62ef9c4ab161)
+  * [Convention Enhancement Proposal No. 9](https://gist.github.com/reactive-firewall/d840ee9990e65f302ce2a8d78ebe73f6)
+* [Security](./SECURITY.md)
+
 ### How do I get this running?
 
 To configure your environment for developing with the multicast library, follow the steps in the
 [Install Guide](./INSTALL.md).
 Key steps include:
 
   1. Ensuring you have a supported version of Python installed.
-  2. use pip to install
-  3.
+  2. Use pip to install (e.g., `pip install multicast`)
+  3. Verify the installation works:
 
   | _in `Python`_ | _in `bash`_ |
   |---------------|-------------|
@@ -39,15 +48,17 @@ can then proceed to implement a more advanced solution in Python as necessary.
 python3 -m multicast --daemon --use-std HEAR --port 59595 --group 224.0.0.1
 ```
 
-| Explanation of the Command-Line Options | |
-|---------------------|---------------------|
+**Explanation of the Command-Line Options**  <!-- Not a header due to repeated usage -->
+
+| Option | Description |
+|--------|-------------|
 | `--daemon` | This option runs the multicast listener as a background daemon. |
 | `--use-std` | This specifies the action to take when any output is produced. In this case, it uses the standard output to print received messages instead of the default to just log messages. |
 | `HEAR` | This specifies the action to take. In this case, it will _receive_ multicast. |
 | `--port 59595` | This sets the UDP port number to `59595`, which is used to identify/filter the multicast messages that will be accepted. |
 | `--group 224.0.0.1` | This specifies the multicast group address to join. You can replace `224.0.0.1` with your desired multicast group address. |
 
-##### Steps to Run
+**Steps to Run**  <!-- Not a header due to repeated usage -->
 
   1. Open your terminal.
   2. Ensure you have the multicast module installed and accessible.
@@ -99,15 +110,17 @@ sender(group='224.0.0.1', port=59595, ttl=1, data='Hello, Multicast!')
 python3 -m multicast SAY --group 224.0.0.1 --port 59595 --message "Hello World!"
 ```
 
-| Explanation of the Command-Line Options | |
-|---------------------|---------------------|
+**Explanation of the Command-Line Options**  <!-- Not a header due to repeated usage -->
+
+| Option | Description |
+|--------|-------------|
 | `SAY` | This specifies the action to take. In this case, it will _transmit_ multicast. |
 | `--group 224.0.0.1` | This specifies the multicast group address to transmit messages to. You can replace `224.0.0.1` with your desired multicast group address. |
 | `--port 59595` | This sets the UDP port number to `59595`, which is used by other members of the multicast group to help identify/filter the multicast messages to accept. |
 | `--message` | This specifies the rest of the input is to be the message to transmit. |
 | `"Hello World!"` | This specifies the multicast message content to _transmit_. In this case, it is the greeting "Hello World!" |
 
-##### Step-by-step
+**Steps to Run**  <!-- Not a header due to repeated usage -->
 
   1. Open your terminal.
   2. Ensure you have the multicast module installed and accessible.
@@ -127,7 +140,6 @@ functionality to ensure that messages are being transmitted and received correct
 # Optional setup console logging
 import logging
 multicast_logging_sink = logging.getLogger()
-handler = logging.StreamHandler()
 multicast_logging_sink.setLevel(logging.INFO)  # increase default logging from multicast module
 handler = logging.StreamHandler()  # example trivial log handler
 multicast_logging_sink.addHandler(handler)

docs/USAGE.md

@@ -2,20 +2,21 @@
 
 ## Basic Library Usage
 
-The API is in a continuous state of improvement, so version pinning is recommended for now.
+> [!NOTE]
+> The API is in a continuous state of improvement, so version pinning is recommended for now.
 
 ### Listening to Multicast
 
 The preferred way to receive multicast messages is to allow the `multicast.hear.McastServer`
-template class handle the ephemeral multicast receivers as a kind of multicast server, allowing
+template class to handle the ephemeral multicast receivers as a kind of multicast server, allowing
 a handler to focus on processing the data.
 
 Here is an example of multicast socket server usage (circa v2.1)
 
 ```python3
 # imports
 import multicast
-from multiprocessing import Process as Process
+from multiprocessing import Process
 import random  # for random port
 
 # Multicast group address and port
@@ -62,7 +63,6 @@ p.start()
 > # setup console logging as example
 > import logging
 > multicast_logging_sink = logging.getLogger()
-> handler = logging.StreamHandler()
 > multicast_logging_sink.setLevel(logging.INFO)  # increase default logging from multicast module
 > handler = logging.StreamHandler()  # example trivial log handler
 > multicast_logging_sink.addHandler(handler)
@@ -74,19 +74,19 @@ p.start()
 > listener = hear.McastHEAR()
 >
 > # Listen for messages indefinitely (use control+C to stop)
-> listener(group='224.0.0.1', port=59259, ttl=1)
+> listener(group='224.0.0.1', port=59595, ttl=1)
 > ```
 
 ### Sending Multicast Transmissions
 
 ```python3
 # imports
-from multiprocessing import Process as Process
+from multiprocessing import Process
 import multicast
 
 # Multicast group address and port
 MCAST_GRP = "224.0.0.1"  # Replace with your multicast group address (use IPv4 dotted notation)
-MCAST_PORT = int(59595)  # Replace with your multicast port (use the same port as the listeners)
+MCAST_PORT = 59595  # Replace with your multicast port (use the same port as the listeners)
 
 # Other important settings (Non-Multicast)
 # Multicast does not care about the host IP, but the UDP protocol layer of the Python socket does
@@ -129,7 +129,7 @@ finally:
 ### Custom handlers
 
 > [!TIP]
-> The API for custom handlers currently requires implementing a sub-class
+> The API for custom handlers currently requires implementing a subclass
 > `multicast.hear.HearUDPHandler` and handling the listener's `multicast.hear.McastServer` server
 > directly with something like this:
 >