@appland/appmap 3.168.0 → 3.168.1

package/built/docs/navie-reference/navie-options.md

@@ -0,0 +1,87 @@
+---
+layout: docs
+title: Docs - AppMap Navie
+description: "Reference Guide to AppMap Navie AI, a complete list of options available in AppMap Navie AI."
+name: Navie Options
+navie-reference: true
+step: 4
+toc: true
+---
+
+# Navie Options
+
+Navie supports forward-slash options that can be included at the beginning of your questions to control various aspects of text generation. 
+
+## /tokenlimit
+
+The `/tokenlimit` option is used to specify a limit on the number of tokens processed by the system. This parameter can help control the length of the generated text or manage resource consumption effectively.
+
+**Syntax**
+```shell
+/tokenlimit=<value>
+```
+- `<value>`: The maximum number of tokens to be processed. This can be either a string or a number. If provided as a string, it will be automatically converted to an integer.
+
+**Description**
+When executing commands, the `/tokenlimit` option sets the upper limit on the number of tokens the system should utilize. The default token limit is 8000. Increasing the token limit allows more space for context.
+
+**Example**
+To set the token limit to 16000, you can use:
+```shell
+@explain /tokenlimit=16000 <question>
+```
+
+**Notes**
+- It's important to ensure that the value provided for `/tokenlimit` is a valid positive integer.
+- The effect of `/tokenlimit` can directly impact the performance and output length of text generation processes.
+- The `/tokenlimit` cannot be increased above the fundamental limit of the LLM backend. Some backends, such as Copilot, may have a lower token limit than others.
+
+
+## /temperature
+
+The `/temperature` option is used to control the randomness of the text generation process. This parameter can help adjust the creativity and diversity of the generated text.
+
+**Syntax**
+```shell
+/temperature=<value>
+```
+
+- `<value>`: The temperature value to be set. This can be either a string or a number. If provided as a string, it will be automatically converted to a float.
+
+**Description**
+When executing commands, the `/temperature` option sets the randomness of the text generation process. The default temperature value is 0.2. Lower values result in more deterministic outputs, while higher values lead to more creative and diverse outputs.
+
+**Example**
+To set the temperature to 0, you can use:
+```shell
+@generate /temperature=0 <question>
+```
+
+**Notes**
+
+- It's important to ensure that the value provided for `/temperature` is a valid float.
+- The effect of `/temperature` can directly impact the creativity and diversity of the generated text.
+
+## /include and /exclude
+
+The `/include` and `/exclude` options are used to include or exclude specific file patterns from the retrieved context.
+
+**Syntax**
+```shell
+/include=<word-or-pattern>|<word-or-pattern> /exclude=<word-or-pattern>|<word-or-pattern>
+```
+
+- `<word-or-pattern>`: The word or pattern to be included or excluded. Multiple values or patterns can be separated by a pipe `|`, because the entire string is treated as a
+  regular expression.
+
+**Description**
+
+When executing commands, the `/include` option includes files according to the words or patterns specified, while the `/exclude` option excludes them. This can help control the context used by the system to generate text.
+
+**Example**
+
+To include only Python files and exclude files containing the word "test":
+
+```shell
+@plan /include=\.py /exclude=test
+```

package/built/docs/navie-reference/navie-pre-built-libraries-for-appmap-data.md

@@ -0,0 +1,23 @@
+---
+layout: docs
+title: Docs - AppMap Navie
+description: "Reference Guide to AppMap Navie AI, pre-built libraries for recording AppMap data."
+name: Pre-built Libraries for Recording AppMap Data
+navie-reference: true
+step: 12
+---
+
+# Pre-built Libraries for Recording AppMap Data
+
+AppMap Navie AI supports all software languages and frameworks for coding with static analysis and static diagrams based on the software.
+
+For advanced runtime analysis of deep tracing of APIs, packages, classes, functions, databases, etc. behavioral analysis, make AppMap data for your project available to Navie.
+
+AppMap offers pre-built libraries for creating AppMap data:  
+
+- [Java](https://github.com/getappmap/appmap-java)
+- [Ruby](https://github.com/getappmap/appmap-ruby)
+- [Python](https://github.com/getappmap/appmap-python)
+- [Node.js](https://github.com/getappmap/appmap-agent-js)
+
+To learn how to make AppMap data of these languages, refer to [making AppMap Data documentation](/docs/get-started-with-appmap/making-appmap-data)

package/built/docs/navie-reference/navie-user-interface.md

@@ -0,0 +1,32 @@
+---
+layout: docs
+title: Docs - Reference
+name: Navie User Interface
+step: 11
+navie-reference: true
+description: "Reference Guide to AppMap Navie AI, describing the user interface."
+---
+
+## User Interface
+AppMap Navie AI is an AI assistant that enables you to ask architectural level questions about your code base. Navie is also able to help you generate new code that can span across your entire project. The primary user interface for Navie is within your VS Code or JetBrains code editor.  Refer to the Navie docs to [learn how to open Navie](/docs/using-navie-ai/how-to-open-navie) for your code editor. 
+
+![Navie User Interface](/assets/img/docs/appmap-navie-user-interface.webp)
+
+### Basic Layout
+
+The Navie user interface consists of 5 key areas. 
+
+<ol type="A">
+  <b><li>AppMap Data Status Panel</li></b>
+  This panel will list the current status of the AppMap Data that has been created for your project.  AppMap Data are your application runtime traces which include things like HTTP and SQL requests, data flows, class and function level instrumentation, and more. Without AppMap Data created for your project, Navie can search through your static source code in your workspace for relevant code snippets. 
+  <b><li>Navie Context Window</li></b>
+  Upon asking a question to Navie it will search through your AppMap Data (if exists) and the source code in your open workspace to locate all the relevant context for your question. This area will reflect the information that Navie is aware of when answering. You can use this information to better understand how Navie is responding.
+  <b><li>LLM Model Config Button</li></b>
+  You can configure Navie to use your own OpenAI API key or bring your own LLM model running locally or within another provider. Clicking the gear icon will open the configuration modal for the bring your own model settings.  <a href="/docs/using-navie-ai/bring-your-own-model">Refer to the AppMap docs for more details</a>
+ about how to configure Navie to use your own LLM models. 
+  <b><li>Active LLM Model</li></b>
+  This panel will display the currently configured LLM model in use with Navie.  The LLM details are displayed in the following format: <code>Model: &lt;Model Name&gt; (&lt;location&gt;)</code>.  When using the default Navie backend, the location will be listed as <code>default</code>. When using your own OpenAI API key the location will be listed as <code>via OpenAI</code>.  When using <a href="/docs/using-navie-ai/bring-your-own-model.html#configuration">Navie Bring Your Own Model</a>
+, the location will be the value of the <code>OPENAI_BASE_URL</code> environment variable, for example <code>via localhost</code> when using <a href="/docs/using-navie-ai/bring-your-own-model.html#ollama">Ollama</a> or <a href="/docs/using-navie-ai/bring-your-own-model.html#lm-studio">LM Studio</a>. 
+  <b><li>Navie Chat Window</li></b>
+  This is your primary location for interacting with Navie.  Here you can ask Navie questions about how your application works, ask Navie to generate code or test cases, and you can even have Navie create a pull request based on your changes. To learn more about specific Navie commands refer to the <a href="#navie-commands">Navie Commands</a>  section.  
+</ol>

package/built/docs/navie-reference.md

@@ -3,6 +3,7 @@ layout: docs
 title: Docs - Reference
 toc: true
 description: "Reference Guide to AppMap Navie, including advanced usage and configuration"
+redirect_for: [/docs/reference/navie]
 ---
 
 # Navie Reference

package/built/docs/reference/appmap-airgapped-install.md

@@ -0,0 +1,293 @@
+---
+layout: docs
+title: Docs - Reference
+description: "Learn how to install AppMap components like IDE plugins, libraries in a secure or air-gapped network environment."
+toc: true
+reference: true
+name: AppMap Offline Install for Secure Environments
+step: 19
+---
+
+# AppMap Offline Install for Secure Environments
+
+- [Assumptions](#assumptions)
+- [Download Steps](#download-steps)
+  - [Download the AppMap VS Code Plugin (VSIX)](#download-the-appmap-vs-code-plugin-vsix)
+  - [Download the AppMap JetBrains Plugin (zip)](#download-the-appmap-jetbrains-plugin-zip)
+  - [Download the AppMap Application Binaries](#download-the-appmap-application-binaries)
+  - [Download the AppMap Java Jar file](#download-the-appmap-java-jar-file)
+- [Installation Steps](#installation-steps)
+  - [Install the AppMap VS Code Plugin (VSIX)](#install-the-appmap-vs-code-plugin-vsix)
+  - [Install the AppMap Plugin for JetBrains (zip)](#install-the-appmap-plugin-for-jetbrains-zip)
+  - [Install the AppMap Application Binaries for VS Code](#install-the-appmap-application-binaries-for-vs-code)
+  - [Install the AppMap Application Binaries for JetBrains](#install-the-appmap-application-binaries-for-jetbrains)
+  - [Install the AppMap Java Jar file](#install-the-appmap-java-jar-file)
+- [Confirm Successful Installation](#confirm-successful-installation)
+
+## Assumptions
+
+Access to the following domains for downloading the AppMap application assets manually.
+
+* [https://github.com/](https://github.com/)
+  * For downloading the VS Code or JetBrains extension files
+  * For downloading the AppMap application binaries
+* [https://getappmap.com](https://getappmap.com)
+  * To authenticate your VS Code installation
+  * NOTE: This is only necessary if you don’t have AppMap provided license keys.
+
+## Download Steps
+
+### Download the AppMap VS Code Plugin (VSIX)
+
+**If you are a JetBrains User, go to the [download documentation for the JetBrains plugin](#download-the-appmap-jetbrains-plugin-zip).**
+
+Navigate to the the AppMap [VS Code GitHub latest releases page](https://github.com/getappmap/vscode-appland/releases/latest): 
+
+This URL will take you to the most recently released version of the extension.  
+
+Alternatively, you can navigate to [the main releases page](https://github.com/getappmap/vscode-appland/releases/) to install any specific version of the extension. 
+
+Click on the VSIX file to save the file to your local machine. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-1.webp"/> 
+
+### Download the AppMap JetBrains Plugin (zip)
+
+Alternatively if you are a JetBrains user, navigate to the AppMap GitHub repository for the [JetBrains/IntelliJ plugin latest releases page](https://github.com/getappmap/appmap-intellij-plugin/releases/latest). 
+
+Download the zip file and save locally. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-1b.webp"/> 
+
+### Download the AppMap Application Binaries
+
+Navigate to the [AppMap application binaries release page](https://github.com/getappmap/appmap-js/releases).  
+
+Search within the page for a release with the name “@appland/appmap”.  
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-2.webp"/> 
+
+<div class="alert alert-info">NOTE: You may need to navigate to page 2 depending on the number of released AppMap binaries.</div>
+
+Click on the “Assets” button to expand all the available AppMap binaries. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-3.webp"/> 
+
+Download the binary that is specific to your computers’ operating system and architecture.  Optionally download the sha256 file as well if you wish to validate the files’ integrity on your local machine. 
+
+### Download the AppMap Java Jar file
+
+<div class="alert alert-info">NOTE: The VSIX will be bundled with the latest java jar file from the same release, but this is not guaranteed to be the same as the most recently released version. The steps below will ensure you can download the latest release if your machine is unable to manually update.</div>
+
+To record Java applications, you’ll need to download the AppMap Java Jar file for the code editor extension to use.  
+Navigate to the [AppMap Java releases page](https://github.com/getappmap/appmap-java/releases/latest) for the latest releases of this project.
+
+
+In the Assets section, download the `appmap-<version>.jar` file and optionally the .asc file if you would like to validate the file integrity on your local machine. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-4.webp"/> 
+
+## Installation Steps
+
+### Install the AppMap VS Code Plugin (VSIX)
+
+Open VS Code, and then open the Command Palette:
+Mac: `Command + Shift + P`
+Windows: `Control + Shift + P`
+
+After opening the Command Palette, search for “install from VSIX”
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-5.webp"/>
+
+In the following window, locate the VSIX you downloaded previously and select that for installation.
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-6.webp"/>
+
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Shift Bullet Points</title>
+  <style>
+    .shifted-list {
+      padding-left: 40px;
+    }
+  </style>
+</head>
+<body>
+  <div class="alert alert-info">
+    NOTE: If VS Code is able to connect to the following domains, AppMap binary asset download will complete successfully.  
+    <ul class="shifted-list">
+      <li>objects.githubusercontent.com</li>
+      <li>*.github.com</li>
+    </ul>
+    If access to those URLs is blocked, continue to the “Install Application Binaries” steps below.
+  </div>
+</body>
+</html>
+
+### Install the AppMap Plugin for JetBrains (zip)
+
+Open your JetBrains editor, and open the “Settings” page. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-7.webp"/>
+
+The settings page should look similar to below.
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-8.webp"/>
+
+Search for, or select the “Plugins” option, then select the gear icon and choose “Install Plugin from Disk”
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-9.webp"/>
+
+Select the path to the zip file you [downloaded in the previous section](#download-the-appmap-jetbrains-plugin-zip).
+
+After selecting the AppMap zip file, click “Accept” for the “Third-Party Plugins Notice”
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-10.webp"/>
+
+<div class="alert alert-info">Note: After clicking “Accept” to the JetBrains plugin notice you may need to go back to the previous “Install Plugin from Disk” step and repeat to install the plugin.</div>
+
+When the plugin is successfully installed, you will see it in the settings page plugin list. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-11.webp"/>
+
+If you don’t see it in the list, search for AppMap in the search box to confirm the installation is complete. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-12.webp"/>
+
+After closing the settings page, the AppMap plugin will open.  
+
+AppMap collects anonymous usage stats to improve the product, in the pop up on the bottom of the screen, choose to “Opt out” or simply close the popup to keep these anonymous product analytics enabled.
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-13.webp"/>
+
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Shift Bullet Points</title>
+  <style>
+    .shifted-list {
+      padding-left: 40px; /* Adjust this value to shift more or less */
+    }
+  </style>
+</head>
+<body>
+  <div class="alert alert-info">
+    NOTE: If VS Code is able to connect to the following domains, AppMap binary asset download will complete successfully.  
+    <ul class="shifted-list">
+      <li>objects.githubusercontent.com</li>
+      <li>*.github.com</li>
+      <li>registry.npmjs.org</li>
+    </ul>
+    If access to those URLs is blocked, continue to the “Install Application Binaries” steps below.
+  </div>
+</body>
+</html>
+
+### Install the AppMap Application Binaries for VS Code
+
+Copy the binary you downloaded in the [previous step](#download-the-appmap-application-binaries) to the following location.
+
+#### On Mac and Linux  <!-- omit in toc -->
+
+<pre><code>$HOME/.appmap/bin/appmap</code></pre>
+
+The file needs to be made executable. You can run the following command.
+<pre><code>chmod +x $HOME/.appmap/bin/appmap</code></pre>
+
+#### On Windows  <!-- omit in toc -->
+
+<pre><code>%USERPROFILE%\.appmap\bin\appmap.exe</code></pre>
+
+### Install the AppMap Application Binaries for JetBrains
+
+Copy the binary you downloaded in the [previous step](#download-the-appmap-application-binaries) and to the following location.
+
+#### On Mac  <!-- omit in toc -->
+
+<pre><code>$HOME/Library/Caches/JetBrains/appland-plugin/appmap/&lt;version&gt;/appmap-macos-arm64</code></pre>
+
+Create the subdirectories if they don’t already exist. 
+
+For example:
+
+<pre><code>$HOME/Library/Caches/JetBrains/appland-plugin/appmap/3.164.0/appmap-macos-arm64</code></pre>
+
+The file needs to be made executable. You can run the following command.
+
+<pre><code>chmod +x $HOME/Library/Caches/JetBrains/appland-plugin/appmap/3.164.0/appmap-macos-arm64</code></pre>
+
+#### On Linux  <!-- omit in toc -->
+
+<pre><code>$HOME/.cache/JetBrains/appland-plugin/appmap/&lt;version&gt;/appmap-linux-arm64</code></pre>
+
+Create the subdirectories if they don’t already exist. 
+
+For example:
+
+<pre><code>$HOME/.cache/JetBrains/appland-plugin/appmap/3.164.0/appmap-linux-arm64</code></pre>
+
+The file needs to be made executable. You can run the following command
+
+<pre><code>chmod +x $HOME/.cache/JetBrains/appland-plugin/appmap/3.164.0/appmap-linux-arm64</code></pre>
+
+#### On Windows  <!-- omit in toc -->
+
+<pre><code>%LocalAppData%\JetBrains\appland-plugin\appmap\&lt;version&gt;\appmap-win-x64.exe</code></pre>
+
+Or the fully expanded path on windows.
+
+<pre><code>C:\Users\&lt;YourUsername&gt;\AppData\Local\JetBrains\appland-plugin\appmap\&lt;version&gt;\appmap-win-x64.exe</code></pre>
+
+Create the subdirectories if they don’t already exist. 
+
+For Example: 
+
+<pre><code>C:\Users\BobSmith\AppData\Local\JetBrains\appland-plugin\appmap\3.164.0\appmap-win-x64.exe</code></pre>
+
+### Install the AppMap Java Jar file
+
+Copy the <code>appmap-&lt;version&gt;.jar</code> downloaded in the [previous step](#download-the-appmap-java-jar-file) to the following location. Ensure the file is renamed to `appmap.jar`
+
+#### On Mac and Linux  <!-- omit in toc -->
+
+`$HOME/.appmap/lib/java/appmap.jar`
+
+When recording your Java application, you will pass this file location to the JVM running your application like: 
+
+`-javaagent:~/.appmap/lib/java/appmap.jar`
+
+#### On Windows  <!-- omit in toc -->
+
+`%USERPROFILE%\.appmap\lib\java\appmap.jar`
+
+When recording your Java application, you will pass this file location to the JVM running your application like:
+`-javaagent:%USERPROFILE%\.appmap\lib\java\appmap.jar`
+
+
+## Confirm Successful Installation
+
+After completing the install steps, you can confirm the installation was done correctly by doing the following:
+
+### Open a Navie Chat 
+
+Follow the [getting started instructions](/docs/using-navie-ai/how-to-open-navie) to open a new Navie chat window.  
+If the AppMap binaries are installed and executable, you should see a new Navie chat window open successfully. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-14.webp"/>
+
+If the binaries are not installed in the correct location, or are not executable, you will show a new Navie window prompt attempting to open but will hang until timeout. 
+
+<img class="video-screenshot" src="/assets/img/docs/offline-install-15.webp"/>
+
+### Record a Java Application
+
+To test your Java Jar file is in the right location and working correctly, simply record a java application using the Java command flag.  
+
+Refer to the [AppMap Agent for Java](/docs/reference/appmap-java) documentation for more information about using the AppMap Jar for recording Java applications.
+
+```shell
+$ java -javaagent:$HOME/.appmap/lib/java/appmap.jar -jar target/*.jar
+```

package/built/docs/reference/appmap-client-cli.md

@@ -455,7 +455,7 @@ using the `--filter` option. Here are the steps for using this technique:
 
 1. Open an AppMap in the code editor.
 2. Use the filtering available in the AppMap to hide certain events. ![AppMap Filtering](/assets/img/docs/using_appmap_filter.jpg)
-3. Open the command pallette using `CTRL+SHIFT+P` or `COMMAND+SHIFT+P` on macOS, type `AppMap: Copy Current AppMap State to Clipboard`, then hit `Enter`.
+3. Open the command palette using `CTRL+SHIFT+P` or `COMMAND+SHIFT+P` on macOS, type `AppMap: Copy Current AppMap State to Clipboard`, then hit `Enter`.
 4. Use the copied state as the `--filter` argument to the `prune` command. The `prune` command will remove whatever was filtered in the AppMap in your code editor.
 
 ```shell

package/built/docs/reference/appmap-java.md

@@ -218,7 +218,7 @@ attribute is ignored.
 The `appmap-java` annotations are provided in the package `com.appland:appmap-annotation`, available on [Maven Central](https://search.maven.org/artifact/com.appland/appmap-annotation). To use them, add that package as a dependency in your build configuration file (`pom.xml`, `build.gradle`).
 
 ### @Labels
-`appmap-java` suports the addition of [code labels](/docs/reference/appmap-java.html#annotations) through the `com.appland.appmap.annotation.Labels` annotation.
+`appmap-java` supports the addition of [code labels](/docs/reference/appmap-java.html#annotations) through the `com.appland.appmap.annotation.Labels` annotation.
 
 #### Usage
 Once the `Labels` annotation is available, you can apply it to methods in your application. For example:

package/built/docs/reference/guides/exporting-appmap-diagrams.md

@@ -5,6 +5,7 @@ description: "Learn how to export your AppMap Diagrams into raw JSON format, SVG
 guides: true
 name: Exporting AppMap Diagrams
 step: 4
+redirect_from: [/docs/guides/exporting-appmap-diagrams]
 ---
 
 # Exporting AppMap Diagrams <!-- omit in toc -->

package/built/docs/reference/guides/handling-large-appmap-diagrams.md

@@ -5,7 +5,7 @@ description: "Learn how to manage large AppMap Diagrams effectively. Discover ti
 guides: true
 name: Handling Large AppMap Diagrams
 step: 4
-redirect_from: [/docs/reference/handling-large-appmaps, /docs/reference/guides/handling-large-appmaps]
+redirect_from: [/docs/reference/handling-large-appmaps, /docs/reference/guides/handling-large-appmaps, /docs/guides/handling-large-appmap-diagrams]
 ---
 
 # Handling Large AppMap Diagrams <!-- omit in toc -->

package/built/docs/reference/guides/index.md

@@ -3,6 +3,7 @@ layout: docs
 title: Docs - How-To Guides
 description: "Learn how to leverage AppMap effectively with guides on handling large AppMap Diagrams, reading SQL, refining, generating OpenAPI, reverse engineering, and more."
 step: 1
+redirect_from: [/docs/guides]
 ---
 
 # How-To Guides

package/built/docs/reference/guides/navigating-code-objects.md

@@ -5,7 +5,7 @@ description: "Explore AppMap's Code Objects view to navigate code functions, HTT
 guides: true
 name: Navigating Code Objects
 step: 3
-redirect_from: [/docs/your-first-15-minutes-with-appmap/navigating-code-objects, /docs/setup-appmap-in-your-code-editor/navigating-code-objects]
+redirect_from: [/docs/your-first-15-minutes-with-appmap/navigating-code-objects, /docs/setup-appmap-in-your-code-editor/navigating-code-objects, /docs/guides/navigating-code-objects]
 ---
 
 # Navigating Code Objects
@@ -36,7 +36,7 @@ There are three sections to the Code Objects view. The first section is the Code
 
 In the HTTP Service request list, you can see basically a mini spec file showing you what routes are available across all of your AppMap Diagrams. 
 
-If this route only exists in a single AppMap, you’ll be taken directly to the AppMap for this request, but if the route exists in multiple diagrams you’ll get a VScode picker to choose which one to open. 
+If this route only exists in a single AppMap, you’ll be taken directly to the AppMap for this request, but if the route exists in multiple diagrams you’ll get a VSCode picker to choose which one to open. 
 
 Here is this route, and here it is shown in a trace view, and you’ll see the status code for that is 302 which is a redirect.
 

package/built/docs/reference/guides/openapi.md

@@ -5,7 +5,7 @@ description: "Use AppMap to auto generate OpenAPI definitions and document HTTP
 guides: true
 name: Generating OpenAPI Definitions
 step: 7
-redirect_from: [/docs/openapi,/docs/openapi/features,/docs/openapi/code-editor-extensions,/docs/openapi/integrations,/docs/openapi/customization,/docs/reference/openapi]
+redirect_from: [/docs/guides/openapi, /docs/openapi,/docs/openapi/features,/docs/openapi/code-editor-extensions,/docs/openapi/integrations,/docs/openapi/customization,/docs/reference/openapi]
 ---
 
 

package/built/docs/reference/guides/reading-sql-in-appmap-diagrams.md

@@ -5,7 +5,7 @@ description: "Discover SQL commands in AppMap Diagrams to analyze application lo
 guides: true
 name: Reading SQL in AppMap Diagrams
 step: 5
-redirect_from: [/docs/reference/guides/reading-sql-in-appmaps]
+redirect_from: [/docs/reference/guides/reading-sql-in-appmaps, /docs/guides/reading-sql-in-appmap-diagrams]
 ---
 
 ## Reading SQL in AppMap Diagrams

package/built/docs/reference/guides/refine-appmap-data.md

@@ -5,7 +5,7 @@ description: "Optimize AppMap Diagrams by refining recordings to exclude noise.
 guides: true
 name: Refining AppMap Data
 step: 6
-redirect_from: [/docs/reference/refine-appmaps, /docs/reference/guides/refine-appmaps]
+redirect_from: [/docs/reference/refine-appmaps, /docs/reference/guides/refine-appmaps /docs/guides/refine-appmap-data]
 ---
 
 # Refining AppMap Data <!-- omit in toc -->

package/built/docs/reference/guides/reverse-engineering.md

@@ -6,6 +6,7 @@ description: "Learn to reverse engineer efficiently using AppMap. Capture code e
 step: 9
 render_with_liquid: false
 name: Reverse Engineering
+redirect_from: [/docs/guides/reverse-engineering]
 ---
 
 # Reverse Engineering with AppMap <!-- omit in toc -->

package/built/docs/reference/guides/using-appmap-analysis.md

@@ -5,7 +5,7 @@ description: "Configure AppMap Analysis by customizing checks for flexible rule
 guides: true
 name: Using AppMap Analysis
 step: 8
-redirect_from: [/docs/analysis/configuring-checks, /docs/analysis/match-pattern-config, /docs/analysis/findings,/docs/reference/configuring-analysis,/docs/reference/guides/configuring-analysis, /docs/analysis]
+redirect_from: [/docs/analysis/configuring-checks, /docs/analysis/match-pattern-config, /docs/analysis/findings,/docs/reference/configuring-analysis,/docs/reference/guides/configuring-analysis, /docs/analysis, /docs/guides/using-appmap-analysis]
 ---
 
 # AppMap Analysis

package/built/docs/reference/guides/using-appmap-diagrams.md

@@ -6,7 +6,7 @@ guides: true
 toc: true
 name: Using AppMap Diagrams
 step: 2
-redirect_from: [/docs/how-to-use-appmap-diagrams.html, /docs/how-to-use-appmap-diagrams, /docs/diagrams/how-to-use-appmaps, /docs/diagrams/sequence-diagrams, /docs/diagrams, /docs/diagrams/how-it-works, /docs/diagrams/dependency-map, /docs/diagrams/trace-view, /docs/diagrams/sequence-diagram, /docs/diagrams/flamegraph, /docs/setup-appmap-in-your-code-editor/navigating-appmap-diagrams]
+redirect_from: [/docs/how-to-use-appmap-diagrams.html, /docs/how-to-use-appmap-diagrams, /docs/diagrams/how-to-use-appmaps, /docs/diagrams/sequence-diagrams, /docs/diagrams, /docs/diagrams/how-it-works, /docs/diagrams/dependency-map, /docs/diagrams/trace-view, /docs/diagrams/sequence-diagram, /docs/diagrams/flamegraph, /docs/setup-appmap-in-your-code-editor/navigating-appmap-diagrams, /docs/guides/using-appmap-diagrams]
 ---
 
 # Using AppMap Diagrams <!-- omit in toc -->
@@ -264,7 +264,7 @@ Flame Graphs make it easy to see how much time is spent in each function, and wh
 
 ### How to read a Flame Graph
 
-The lowest layer in a Flame Graph represents the AppMap Data recording, and it contains the recordings’s name. For an AppMap Flame Graph created from tests, this will usually be the same name as the test from which it was generated. In the example below, the AppMap was recorded from a test related to an application’s account activation capability.
+The lowest layer in a Flame Graph represents the AppMap Data recording, and it contains the recording's name. For an AppMap Flame Graph created from tests, this will usually be the same name as the test from which it was generated. In the example below, the AppMap was recorded from a test related to an application’s account activation capability.
 
 ![flame graph image](/assets/img/docs/flamegraph-8.webp)
 

package/built/docs/reference/index.md

@@ -21,6 +21,8 @@ redirect_from: [/docs/reference/browser-extension]
 - [Remote recording API](/docs/reference/remote-recording-api)
 - [Analysis Rules](/docs/reference/analysis-rules)
 - [Analysis Labels](/docs/reference/analysis-labels)
+- [License Key Installation](/docs/reference/license-key-install)
+- [AppMap Offline Install for Secure Environments](/docs/reference/appmap-airgapped-install)
 - [Uninstalling AppMap](/docs/reference/uninstalling-appmap)
 
 ## Advanced AppMap Data Management
@@ -34,7 +36,7 @@ redirect_from: [/docs/reference/browser-extension]
 - [Using AppMap Analysis](/docs/reference/guides/using-appmap-analysis.html)
 - [Reverse Engineering](/docs/reference/guides/reverse-engineering.html)
 
-## integrations
+## Integrations
 
 - [Atlassian Compass](/docs/reference/integrations/atlassian-compass.html)
 - [Atlassian Confluence](/docs/reference/integrations/atlassian-confluence.html)

package/built/docs/reference/integrations/atlassian-compass.md

@@ -5,6 +5,7 @@ description: "Atlassian Compass is a unified platform for managing distributed s
 integrations: true
 name: Atlassian Compass
 step: 1
+redirect_from: [/docs/integrations/atlassian-compass]
 ---
 
 # Atlassian Compass

package/built/docs/reference/integrations/atlassian-confluence.md

@@ -5,6 +5,7 @@ description: "AppMap integrates with Atlassian Confluence to generate interactiv
 integrations: true
 name: Atlassian Confluence
 step: 1
+redirect_from: [/docs/integrations/atlassian-confluence]
 ---
 
 # Atlassian Confluence

package/built/docs/reference/integrations/docker.md

@@ -5,6 +5,7 @@ description: "Learn how to record AppMap Data inside a Docker container for cons
 integrations: true
 name: Docker
 step: 7
+redirect_from: [/docs/integrations/docker]
 ---
 
 # Docker

package/built/docs/reference/integrations/index.md

@@ -3,6 +3,7 @@ layout: docs
 title: Docs - Integrations
 description: "Explore how to integrate AppMap with popular services like Atlassian Compass, Confluence, GitHub Actions, CircleCI, PlantUML, Postman, SwaggerHub, Readme.com, and Docker"
 toc: false
+redirect_from: [/docs/integrations]
 ---
 
 # Integrations

package/built/docs/reference/integrations/mermaid.md

@@ -5,6 +5,7 @@ description: "Generate Mermaid diagrams with AppMap Navie. Download, edit, and s
 integrations: true
 name: Mermaid
 step: 4
+redirect_from: [/docs/integrations/mermaid]
 ---
 
 # Mermaid