Cleanup documentation with latest changes (#228)

This is a cleanup for the documentation with some missing additions.

Author: Corentin Mors

documentation/pages/business/index.mdx

@@ -4,11 +4,12 @@ import { Callout } from 'nextra/components';
 
 Commands related to business use a different authentication than your personal vault.
 
-Commands are calling a server API to perform actions and retrieve data. The first step is to login with the personal account ([follow this guide](/personal/authentication)) of a team admin and to generate a set of credentials.
+Commands are calling a server API to perform actions and retrieve data.
+The first step is to login with the personal account ([follow this guide](../personal/authentication.mdx)) of a team admin and to generate a set of credentials.
 
 ## Generate credentials
 
-<Callout emoji="💡">Needs to be authenticated as an admin to use this command.</Callout>
+<Callout>Needs to be authenticated as an admin to use this command.</Callout>
 
 ```sh copy
 dcli t credentials generate
@@ -28,19 +29,19 @@ set DASHLANE_TEAM_DEVICE_KEYS=dlt_[deviceAccessKey]_[payload]
 
 Make sure you save them in a safe place (use a secure note for instance 😉).
 
-<Callout emoji="ℹ️">The token you'll get is starting by `dlt` in order to be easily identified by scanning tools.</Callout>
+<Callout type="info">The token you'll get is starting by `dlt` in order to be easily identified by scanning tools.</Callout>
 
 ## List credentials
 
-<Callout emoji="💡">Needs to be authenticated as an admin to use this command.</Callout>
+<Callout>Needs to be authenticated as an admin to use this command.</Callout>
 
 ```sh copy
 dcli t credentials list
 ```
 
 ## Revoke credentials
 
-<Callout emoji="💡">Needs to be authenticated as an admin to use this command.</Callout>
+<Callout>Needs to be authenticated as an admin to use this command.</Callout>
 
 ```sh copy
 dcli t credentials revoke <DASHLANE_TEAM_ACCESS_KEY>

documentation/pages/business/members.mdx

@@ -2,7 +2,7 @@ import { Callout } from 'nextra/components';
 
 # Listing members
 
-<Callout emoji="💡">Needs team credentials to use this command.</Callout>
+<Callout>Needs team credentials to use this command.</Callout>
 
 ## Fetching the list of members
 

documentation/pages/install.mdx

@@ -1,10 +1,16 @@
-import { Tab, Tabs } from 'nextra-theme-docs'
+import { Callout, Tab, Tabs } from 'nextra-theme-docs'
 
 # Install
 
-The Dashlane CLI can be installed in multiple ways. You can either install it using [Homebrew](https://brew.sh/) on **macOS** and **Linux**, manually with [Yarn](https://yarnpkg.com/) or download the packaged executables for **Windows**, **macOS** and **Linux** on x64 architectures.
+The Dashlane CLI can be installed in multiple ways.
 
-<Tabs items={['Homebrew', 'Manually with Yarn', 'Packaged Executables (x64 only)']}>
+You can either install it using :
+
+-   [Homebrew](https://brew.sh/) on **macOS** and **Linux**
+-   download the packaged executables for **Windows**, **macOS** and **Linux** on x64 architectures.
+-   manually with [Yarn](https://yarnpkg.com/)
+
+<Tabs items={['Homebrew', 'Packaged Executables (x64 only)', 'Manually with Yarn']}>
     <Tab>
     You can install the Dashlane CLI using [Homebrew](https://brew.sh/), a package manager for __macOS__ and __Linux__.
 
@@ -23,31 +29,6 @@ The Dashlane CLI can be installed in multiple ways. You can either install it us
     The CLI is now installed on your machine, it will be updated automatically when a new version is released.
     </Tab>
     <Tab>
-    This method is available on every environment that supports [Node.js](https://nodejs.org/en/) and Yarn.
-
-    First you need to download or `git clone` this repository and run the following commands in the root directory of the repository.
-
-    Install the dependencies:
-
-    ```sh copy
-    yarn
-    ```
-
-    In order to build:
-
-    ```sh copy
-    yarn run build
-    ```
-
-    In order to link:
-
-    ```sh copy
-    yarn link
-    ```
-
-    Make sure to pull the latest changes and rebuild the project to get the latest version of the CLI.
-    </Tab>
-    <Tab>
     Head to the [releases page](https://github.com/Dashlane/dashlane-cli/releases) and download the latest version of the CLI for your platform (Windows, macOS or Linux).
 
     You may need to mark the binary as executable (on macOS and Linux):
@@ -80,6 +61,33 @@ The Dashlane CLI can be installed in multiple ways. You can either install it us
 
     You will need to get the latest version of the CLI manually by downloading the latest release and replacing the binary in your bin folder.
     </Tab>
+    <Tab>
+    <Callout type="warning">We do not recommend the manual install for personal computers, if you plan to use the local keychain, as the NodeJS process will be the owner of your secrets, we recommend to use a packaged version.</Callout>
+
+    This method is available on every environment that supports [Node.js](https://nodejs.org/en/) and Yarn.
+
+    First you need to download or `git clone` this repository and run the following commands in the root directory of the repository.
+
+    Install the dependencies:
+
+    ```sh copy
+    yarn
+    ```
+
+    In order to build:
+
+    ```sh copy
+    yarn run build
+    ```
+
+    In order to link:
+
+    ```sh copy
+    npm link
+    ```
+
+    Make sure to pull the latest changes and rebuild the project to get the latest version of the CLI.
+    </Tab>
 
 </Tabs>
 

documentation/pages/logout.mdx

@@ -8,8 +8,6 @@ If you want to start fresh with the CLI or use another account, you can logout a
 dcli logout
 ```
 
-<Callout type="info" emoji="ℹ️">
-    This does not perform an account reset, it only resets the local data on the device.
-</Callout>
+<Callout type="info">This does not perform an account reset, it only resets the local data on the device.</Callout>
 
 A confirmation will be asked, then the local database containing your encrypted data will be wiped and any entry related to the CLI will be removed from the OS keychain.

documentation/pages/personal/authentication.mdx

@@ -16,7 +16,7 @@ You will be then asked to validate a second factor to register the CLI to your a
 -   Master Password
 -   SSO (self-hosted only)
 
-<Callout type="warning" emoji="⚠️">
+<Callout type="warning">
     Confidential SSO (using Nitro Enclaves) and Password-Less authentication are not supported yet.
 </Callout>
 

documentation/pages/personal/backup.mdx

@@ -5,11 +5,11 @@ The command will perform a sync prior to the backup to ensure that the latest da
 
 The backup is a [sqlite3](https://www.sqlite.org/index.html) database file containing all your secrets encrypted by your master password.
 
-```bash
-# By default the backup file is stored in the current directory and named dashlane-backup-<timestamp>.db
+```sh copy filename="By default the backup file is stored in the current directory and named dashlane-backup-<timestamp>.db"
 dcli backup
+```
 
-# You can specify the directory and filename
+```sh copy filename="You can specify the directory and filename"
 dcli backup --filename <filename> --directory <directory>
 ```
 

documentation/pages/personal/devices.mdx

@@ -46,7 +46,7 @@ dcli devices remove --others
 dcli devices remove --all
 ```
 
-<Callout type="info" emoji="ℹ️">
+<Callout type="info">
     If you remove the current CLI device, you will need to do a `dcli logout` in order to re-authenticate.
 </Callout>
 
@@ -64,7 +64,7 @@ This will create a new device named `my_server` and will print the device creden
 Save them in a safe place (like in a secure note), as you won't be able to retrieve them later.
 Run the suggested commands on your target device (your server or CI) to set the device credentials as environment variables.
 
-```sh 
+```sh
 export DASHLANE_SERVICE_DEVICE_KEYS=dls_[deviceAccessKey]_[payload]
 ```
 
@@ -74,9 +74,11 @@ On Windows, you can use the `set` command instead of `export`.
 set DASHLANE_SERVICE_DEVICE_KEYS=dls_[deviceAccessKey]_[payload]
 ```
 
-<Callout emoji="ℹ️">The token you'll get is starting by `dls` in order to be easily identified by scanning tools.</Callout>
+<Callout type="info">
+    The token you'll get is starting by `dls` in order to be easily identified by scanning tools.
+</Callout>
 
-<Callout type="warning" emoji="⚠️">
+<Callout type="warning">
     OTP at each login and SSO are not supported for non-interactive devices. We recommend creating a dedicated Dashlane
     account for your non-interactive devices.
 </Callout>

documentation/pages/personal/secrets/inject.mdx

@@ -42,8 +42,6 @@ In output file, the secret reference is replaced by the plaintext secret value.
 
 ![Dashlane CLI inject secret](../../../public/inject-pwd.png)
 
-<Callout type="error" emoji="️🚫">
-    Make sure to delete the resolved config file if you no longer need it.
-</Callout>
+<Callout type="error">Make sure to delete the resolved config file if you no longer need it.</Callout>
 
 </Steps>

documentation/pages/personal/secrets/read.mdx

@@ -61,14 +61,15 @@ Available transformers:
 
 You can simply use the `dcli read <path>` command to read a secret reference.
 
-```sh
-# Read the whole secret
+```sh copy filename="Read the whole secret"
 dcli read dl://<secret_identifier>
+```
 
-# Read a specific field of the secret
+```sh copy filename="Read a specific field of the secret"
 dcli read dl://<secret_identifier>/<field>
+```
 
-# Read a specific field of the secret and apply a transformer
+```sh copy filename="Read a specific field of the secret and apply a transformer"
 dcli read dl://<secret_identifier>/<field>?<transformer>
 ```
 

documentation/pages/personal/vault.mdx

@@ -3,48 +3,62 @@ import { YoutubePlayer } from '../../components/player';
 
 # Accessing your Vault
 
-<Callout type="info" emoji="ℹ️">
-    For now accessing your vault is read only.
-</Callout>
+<Callout type="info">For now accessing your vault is read only.</Callout>
 
 ## Get a password
 
 <YoutubePlayer videoId="dMII21YI5s4" />
 
-```sh
+```sh copy filename="Return any entry for which either the url or the title matches mywebsite"
 dcli p mywebsite
-# will return any entry for which either the url or the title matches mywebsite
+```
 
+```sh copy filename="Copy the login of the selected entry for which either the url or the title matches mywebsite to the clipboard"
 dcli p mywebsite -f login
-# will copy the login of the selected entry for which either the url or the title matches mywebsite to the clipboard
+```
 
+```sh copy filename="Print the email of the selected entry for which either the url or the title matches mywebsite to the console"
 dcli p mywebsite -f email -o console
-# will print the email of the selected entry for which either the url or the title matches mywebsite to the console
+```
 
+```sh copy filename="Print the json of the entry for which either the url or the title matches mywebsite to the console"
 dcli p mywebsite -o json
-# will print the json of the entry for which either the url or the title matches mywebsite to the console
+```
 
+```sh copy filename="Return any entry for which the id matches xxxxxx"
 dcli p id=xxxxxx
-# will return any entry for which the id matches xxxxxx
+```
 
+```sh copy filename="Return any entry for which the url matches someurl, or the title matches mytitle"
 dcli p url=someurl title=mytitle
-# will return any entry for which the url matches someurl, or the title matches mytitle
+```
 
+```sh copy filename="Return any entry for which either the url or the title matches mywebsite"
 dcli p url,title=mywebsite
-# will return any entry for which either the url or the title matches mywebsite
 ```
 
-Note: You can select a different output for passwords among `clipboard, password, json`. The JSON option outputs all the matching credentials.
+**Note:** You can select a different output for passwords among `clipboard, console, json`. The JSON option outputs all the matching credentials.
 
 ![Dashlane CLI copy password](../../public/password-copy.png)
 
-## Generate an OTP code
+### Get the email or login of a password
+
+You can get the email or username of a password by using the `--field` or `-f` parameter:
+
+```sh copy
+dcli password -f email mywebsite
+```
+
+```sh copy
+dcli password -f login mywebsite
+```
+
+### Generate an OTP code
 
 You can get an OTP code from your vault as well as the remaining time before it expires.
-Just use the `otp` or `o` command and filter similarly to the password command:
 
 ```sh copy
-dcli otp [filters]
+dcli password -f otp mywebsite
 ```
 
 ## Get a secure note
@@ -70,8 +84,9 @@ You can also select a different output for notes among `text, json`. The JSON op
 
 ```sh copy
 dcli secret [filters]
+```
 
-# Example with a JSON output
+```sh copy filename="Example: get the secret with the title api_keys and a JSON output"
 dcli secret title=api_keys -o json
 ```
 
@@ -93,8 +108,7 @@ This could be useful if you want to share SSH keys with your team.
 
 Let's say you have generated a new SSH key pair and you want to store it in Dashlane.
 
-```sh
-# this is an example, use the parameters you want
+```sh copy filename="This is an example, use the parameters you want"
 ssh-keygen -t rsa -b 4096 -C "Dashlane SSH demo key"
 ```