[observability] Spot check rendering/syntax issues (elastic#1078)

Spot checks rendering/syntax issues in Solutions → Observability.

Author: colleenmcginnis

solutions/images/observability-help-icon.png

@@ -199,7 +199,6 @@ APM Server provides a command line interface for creating, retrieving, invalidat
         | `manage_own_api_key` | Allow APM Server to create, retrieve, and invalidate API keys |
 
     2. Depending on what the **API key role** will be used for, also assign the appropriate `apm` application-level privileges:
-
         * To **receive Agent configuration**, assign `config_agent:read`.
         * To **ingest agent data**, assign `event:write`.
         * To **upload source maps**, assign `sourcemap:write`.

solutions/images/observability-help-icon.svg

@@ -75,7 +75,6 @@ apm-server apikey SUBCOMMAND [FLAGS]
         | `manage_own_api_key` | Allow APM Server to create, retrieve, and invalidate API keys |
 
     2. Depending on what the **API key role** will be used for, also assign the appropriate `apm` application-level privileges:
-
         * To **receive Agent configuration**, assign `config_agent:read`.
         * To **ingest agent data**, assign `event:write`.
         * To **upload source maps**, assign `sourcemap:write`.

solutions/images/observability-transaction-icon.png

@@ -67,8 +67,7 @@ tar xzvf apm-server-{{apm_server_version}}-darwin-x86_64.tar.gz
 $$$apm-installing-on-windows$$$
 **Windows:**
 
-1. Download the APM Server Windows zip file from the
-https://www.elastic.co/downloads/apm/apm-server[downloads page].
+1. Download the APM Server Windows zip file from the [downloads page](https://www.elastic.co/downloads/apm/apm-server).
 
 1. Extract the contents of the zip file into `C:\Program Files`.
 

solutions/images/observability-transaction-icon.svg

@@ -182,10 +182,9 @@ To send APM data to Elastic, you must install an APM agent and configure it to s
 
         If you can’t find your distribution, you can install the agent by building it from the source. The following instructions will build the APM agent using the same docker environment that Elastic uses to build our official packages.
 
-        ::::{note}
+        ```{note}
         The agent is currently only available for Linux operating system.
-
-        ::::
+        ```
 
         1. Download the [agent source](https://github.com/elastic/apm-agent-php/).
         2. Execute the following commands to build the agent and install it:

solutions/observability/apm/api-keys.md

@@ -26,7 +26,7 @@ View the installation layout and default paths for both Fleet-managed APM Server
 :   Main {{agent}} {{fleet}} encrypted configuration
 
 `/Library/Elastic/Agent/data/elastic-agent-*/logs/elastic-agent.ndjson`
-:   Log files for {{agent}} and {{beats}} shippers <sup class="footnote" id="_footnote_lognumbering">[<a id="_footnoteref_1" class="footnote" href="#_footnotedef_1" title="View footnote.">1</a>]</sup>
+:   Log files for {{agent}} and {{beats}} shippers[¹](#footnote-1)
 
 `/usr/bin/elastic-agent`
 :   Shell wrapper installed into PATH
@@ -45,7 +45,7 @@ You can install {{agent}} in a custom base path other than `/Library`.  When ins
 :   Main {{agent}} {{fleet}} encrypted configuration
 
 `/opt/Elastic/Agent/data/elastic-agent-*/logs/elastic-agent.ndjson`
-:   Log files for {{agent}} and {{beats}} shippers <sup class="footnoteref">[<a class="footnote" href="#_footnotedef_1" title="View footnote.">1</a>]</sup>
+:   Log files for {{agent}} and {{beats}} shippers[¹](#footnote-1)
 
 `/usr/bin/elastic-agent`
 :   Shell wrapper installed into PATH
@@ -64,7 +64,7 @@ You can install {{agent}} in a custom base path other than `/opt`.  When install
 :   Main {{agent}} {{fleet}} encrypted configuration
 
 `C:\Program Files\Elastic\Agent\data\elastic-agent-*\logs\elastic-agent.ndjson`
-:   Log files for {{agent}} and {{beats}} shippers <sup class="footnoteref">[<a class="footnote" href="#_footnotedef_1" title="View footnote.">1</a>]</sup>
+:   Log files for {{agent}} and {{beats}} shippers[¹](#footnote-1)
 
 You can install {{agent}} in a custom base path other than `C:\Program Files`.  When installing {{agent}} with the `.\elastic-agent.exe install` command, use the `--base-path` CLI option to specify the custom base path.
 ::::::
@@ -80,7 +80,7 @@ You can install {{agent}} in a custom base path other than `C:\Program Files`.
 :   Main {{agent}} {{fleet}} encrypted configuration
 
 `/var/lib/elastic-agent/data/elastic-agent-*/logs/elastic-agent.ndjson`
-:   Log files for {{agent}} and {{beats}} shippers <sup class="footnoteref">[<a class="footnote" href="#_footnotedef_1" title="View footnote.">1</a>]</sup>
+:   Log files for {{agent}} and {{beats}} shippers[¹](#footnote-1)
 
 `/usr/bin/elastic-agent`
 :   Shell wrapper installed into PATH
@@ -97,7 +97,7 @@ You can install {{agent}} in a custom base path other than `C:\Program Files`.
 :   Main {{agent}} {{fleet}} encrypted configuration
 
 `/var/lib/elastic-agent/data/elastic-agent-*/logs/elastic-agent.ndjson`
-:   Log files for {{agent}} and {{beats}} shippers <sup class="footnoteref">[<a class="footnote" href="#_footnotedef_1" title="View footnote.">1</a>]</sup>
+:   Log files for {{agent}} and {{beats}} shippers[¹](#footnote-1)
 
 `/usr/bin/elastic-agent`
 :   Shell wrapper installed into PATH
@@ -150,3 +150,6 @@ For the deb and rpm distributions, these paths are set in the init script or in
 ::::::
 
 :::::::
+
+$$$footnote-1$$$
+¹ Logs file names end with a date (`YYYYMMDD`) and optional number: `elastic-agent-YYYYMMDD.ndjson`, `elastic-agent-YYYYMMDD-1.ndjson`, and so on as new files are created during rotation.

solutions/observability/apm/apm-server-command-reference.md

@@ -53,4 +53,4 @@ Go to the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs
 :alt: scale APM
 :::
 
-Congratulations -- you now have the latest and greatest in Elastic APM!
+Congratulations — you now have the latest and greatest in Elastic APM!