progress

Author: Ethan-Arrowood

learn/getting-started/installation.md …g-started/install-and-connect-harper.mdxlearn/getting-started/installation.md renamed to learn/getting-started/install-and-connect-harper.mdx learn/getting-started/installation.md renamed to learn/getting-started/install-and-connect-harper.mdx

@@ -2,28 +2,55 @@
 title: Install and Connect Harper
 ---
 
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
 # Install and Connect Harper
 
-The recommended approach for efficiently developing applications with Harper is to install Harper locally for efficient development of an application and deploy it to [Harper Fabric](https://fabric.harper.fast), our distributed data application platform service. However, you can also develop directly in Fabric, if you want to quickly try it out. You can also run a self-hosted Harper server, and manage it with our Fabric studio management UI.
+Developers have two recommended approaches for developing Harper applications; either locally or with [Harper Fabric](https://fabric.harper.fast), our distributed data application platform service. If you start developing locally, you can always switch to Fabric by deploying your application. If you're interested in setting up a Fabric instance, navigate to the [Fabric](../../fabric/index.md) part of the documentation, and then come back after you have created your first Fabric cluster.
+
+## Install Harper Locally
 
-## Install with npm
+Harper is published to the npm registry and requires Node.js current, active LTS, or maintenance LTS versions to run.
 
-The fastest way to get Harper running locally is to install with npm. Make sure you have [Node.js](https://nodejs.org/) (LTS or newer). Then run:
+The fastest way to get started is by installing Harper globally using an npm compatible package manager:
 
 ```bash
-npm install -g harperdb
-harperdb
+npm install -g harper
 ```
 
-The first time, you’ll set up your destination, username, password, and [configuration](../deployments/configuration). That’s it! Harper is now running locally.
+Then, execute the Harper CLI to start the interactive installation process:
+
+```bash
+harper install
+```
 
-✅ Quick check: open http://localhost:9925, which will launch the studio UI for managing your local server, or run this for a quick health check:
+After completing the installation, run within the current command process using:
 
 ```bash
-curl http://localhost:9925/health
+harper
 ```
 
-Harper can also be [installed with our Docker image or you can download Harper for manual or offline installation](../deployments/install-harper).
+To check if everything is configured correctly and ready to go for development, run a quick health check using the `/health` endpoint available within the Operations API server.
+
+:::note
+If you configured a different Operations API port, use that instead of `9925` here.
+:::
+
+<Tabs>
+  <TabItem value="curl">
+    ```bash
+    curl http://localhost:9925/health
+    ```
+  </TabItem>
+  <TabItem value="fetch">
+```typescript
+const response = await fetch('http://localhost:9925/health');
+const text = await response.text();
+console.log(text);
+```
+  </TabItem>
+</Tabs>
 
 ## Manage and Deploy with Fabric
 
@@ -44,7 +71,3 @@ Once Harper is running or you are connected to Fabric, we recommend that you wal
 - Explore the [Core Concepts](../foundations/core-concepts)
 - Learn about [Harper's architecture](../foundations/harper-architecture)
 - Review [Configuration options](../deployments/configuration)
-
-:::info
-Need help? Please don’t hesitate to [reach out](https://www.harpersystems.dev/contact).
-:::

learn/index.md

@@ -2,10 +2,34 @@
 title: Welcome to Harper Learn
 ---
 
-Welcome to Harper Learn!
+This documentation section contains thorough guides for learning how to develop and manage applications with Harper. The guides are present in a logical order to build up knowledge across Harper's vast feature set. The guides are example based and provide a hands-on approach to teaching and demonstrating key features. Guides can be referenced independently, but assume the reader is familiar with concepts presented in previous guides.
 
-This section contains thorough guides for learning how to build applications and more with Harper.
+For example, the [Loading Data]() guide assumes the reader already knows how to build a basic Harper application (covered in ), create databases and tables using schemas, and some basic query techniques. Those concepts are specifically covered throughout the [Getting Started](), [Key Harper Application Features](), and [Defining Databases and Tables]() guides.
 
-Each guide contains all necessary prerequisite and setup instructions for examples.
+Most guides present both local-based and [Harper Fabric]() cloud-based examples and instructions. Regardless, in order to properly complete all examples, we recommend the following prerequisite tools installed and configured on your local machine:
 
-The guides are presented in a logical order to built up knowledge across Harper's vast features set. Guides can be referenced independently, but will assume the reader is familiar with concepts contained within previous guides. For example, the [Loading Data]() guide assumes the reader already knows how to build a basic Harper application, create databases and tables using schemas, and some basic query techniques. Those concepts are specifically covered throughout the [Getting Started](), [Key Harper Application Features](), and [Defining Databases and Tables]() guides.
+- Command line access and general file-system and networking permissions
+  - `sudo` is not required
+  - For local development, Harper requires permission to read/write files and localhost networking permissions
+- HTTP Client of choice
+  - Most examples will present both curl and fetch based HTTP requests
+  - GUI-based HTTP clients will also work fine and is left 
+- Node.js Current, Active LTS, or Maintenance LTS version
+  - For more information see [Node.js Releases](https://nodejs.org/en/about/previous-releases)
+  - Verify your Node.js version by running `node -v` in the command line
+- Code editor of choice
+  - Everything from `vim` to Visual Studio Code to WebStorm IDE will work fine for the purposes of these guides
+
+If you ever have questions, join our official community [Discord](https://harper.fast/discord). Furthermore, Harper documentation is open source, if you notice anything out-of-place with the guide content, please [open an issue](https://github.com/HarperFast/documentation/issues) or submit changes directly using the "Edit this page" link at the bottom of every page.
+
+
+:::info
+
+Eagle-eye developers may notice some things still reference Harper's previous name, HarperDB.
+
+The "database" part is not gone, Harper has simply evolved to become so much more than _just_ a database.
+Harper is one-and-the-same with HarperDB, so please bare with us as we chip away at some renames.
+
+:::
+
+When you're ready to get started, click the "Next" tab below to begin your Harper adventure!