Merge pull request #360 from smallstep/carl/agent-update

Clarify distinction between app and agent

Author: tashian

manifest.json

@@ -36,7 +36,7 @@
               "path": "/platform/smallstep-app.mdx"
             },
             {
-              "title": "Smallstep Agent",
+              "title": "Smallstep Agent for Linux",
               "path": "/platform/smallstep-agent.mdx"
             }
           ]

platform/smallstep-agent.mdx

@@ -1,12 +1,14 @@
 ---
-title: Smallstep Agent
+title: Smallstep Agent for Linux
 html_title: Install the Smallstep Agent on a Linux endpoint
 description: The Smallstep agent is used across security, IT, and DevOps teams to enable end-to-end network encryption, privileged access management, passwordless authentication, and much more.
 ---
+The Smallstep Agent for Linux is a background component of the [Smallstep Desktop App](./smallstep-app.mdx).
+Choose one or the other depending on your deployment needs.
 
-While macOS and Windows can manage certificates and authentication settings via Mobile Device Management (MDM), Linux does not include automated remote management facilities. The Smallstep Agent brings vital certificate management features to your Linux users and endpoints. It is the [Smallstep App](./smallstep-app.mdx), without any GUI. It can be installed independently on any Linux device running systemd.
+# Background
 
-Linux users should install either the Smallstep Agent or the Smallstep App—not both.
+While macOS and Windows can manage certificates and authentication settings via Mobile Device Management (MDM), Linux does not include automated remote management facilities. The Smallstep Agent brings vital certificate management features to your Linux users and endpoints. It can be installed independently on any Linux device running systemd.
 
 In this document, we will install, configure, and start the Smallstep Agent on a Linux device running systemd. We also show how to use the agent’s built-in PKCS#11 (smart card) service. With the PKCS#11 service, you can access Smallstep certificates and keys from applications that support PKCS#11.
 

platform/smallstep-app.mdx

@@ -5,12 +5,19 @@ description: This document specifies app download links, system requirements, ru
 ---
 Smallstep ensures that access to financial data, code repositories, PII, and other sensitive resources is only possible from trusted, company-managed devices. 
 
-The Smallstep desktop app is central to that process. It offers a uniform experience for device identity across macOS, Windows, and Linux, and is the foundation for Smallstep's high-assurance device identity attestation workflow, automating the issuance of certificates to devices and configuring the components that depend on these certificates.
+The Smallstep desktop app is central to that process. It offers a uniform experience for device identity across macOS, Windows, and Linux, and is the foundation for Smallstep's high-assurance device identity attestation workflow, automating the issuance of certificates to devices and configuring the components that depend on these certificates. P.S: The Smallstep app operates differently for Linux. For Linux specific instructions, see [Smallstep Agent for Linux](https://smallstep.com/docs/platform/smallstep-agent). 
 
-Here's all the necessary info you need to install and use the app effectively and consciously:
+Here's all the necessary info you need to install and use the Smallstep app effectively and consciously.
 
 ## Download
 
+<Alert severity="info">
+The Smallstep App includes the <a href="smallstep-agent.mdx">Smallstep Agent</a>,
+which runs in the background.
+</Alert>
+
+Installers for macOS, Windows and Linux can be also be downloaded from [GitHub releases](https://github.com/smallstep/smallstep-desktop/releases). Releases are signed with, and can be verified, by cosign.
+
 | Platform  | Release  |
 |:--|:--|
 | macOS  | <a href='https://packages.smallstep.com/stable/darwin/Smallstep.dmg'>Latest Version</a>  |
@@ -19,8 +26,6 @@ Here's all the necessary info you need to install and use the app effectively an
 | Linux (.rpm) | <a href='https://packages.smallstep.com/stable/rpm/smallstep-desktop.rpm'>Latest Version</a>  |
 | Windows  | <a href='https://packages.smallstep.com/stable/windows/Smallstep.exe'>Latest Version</a>  |
 
-Installers for macOS, Windows and Linux can be also be downloaded from [GitHub releases](https://github.com/smallstep/smallstep-desktop/releases). Releases are signed with, and can be verified, by cosign.
-
 ## System Requirements
 
 ### Windows