Address PR comments

Author: nenharper

docs/getting-started/README.md

@@ -7,4 +7,35 @@ Follow the steps in this documentation to discover how Harper can simplify your
 For more advanced concepts in Harper, see our [blog](https://www.harpersystems.dev/blog).
 
 ## Harper Basics
-<table data-column-title-hidden data-view="cards"><thead><tr><th></th><th></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="getting-started/install-harper.md"><strong>Install Harper</strong></a></td><td>Pick the installation method that best suits your environment</td><td></td><td><a href="getting-started/install-harper.md">install-harper</a></td></tr><tr><td><a href="getting-started/what-is-harper.md"><strong>What is Harper</strong></a></td><td>Learn about Harper, how it works, and some of its usecases</td><td></td><td><a href="getting-started/what-is-harper.md">what-is-harper</a></td></tr><tr><td><a href="getting-started/harper-concepts.md"><strong>Harper Concepts</strong></a></td><td>Learn about Harper's fundamental concepts and how they interact</td><td></td><td><a href="getting-started/harper-concepts.md">harper-concepts</a></td></tr></tbody></table>
+<table data-column-title-hidden data-view="cards">
+    <thead>
+        <tr>
+            <th></th>
+            <th></th>
+            <th data-hidden></th>
+            <th data-hidden data-card-target data-type="content-ref"></th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>
+                <a href="getting-started/install-harper.md"><strong>Install Harper</strong></a>
+            </td>
+            <td>Pick the installation method that best suits your environment</td>
+            <td></td>
+            <td><a href="getting-started/install-harper.md">install-harper</a></td>
+        </tr>
+        <tr>
+            <td><a href="getting-started/what-is-harper.md"><strong>What is Harper</strong></a></td>
+            <td>Learn about Harper, how it works, and some of its usecases</td>
+            <td></td>
+            <td><a href="getting-started/what-is-harper.md">what-is-harper</a></td>
+        </tr>
+        <tr>
+            <td><a href="getting-started/harper-concepts.md"><strong>Harper Concepts</strong></a></td>
+            <td>Learn about Harper's fundamental concepts and how they interact</td>
+            <td></td>
+            <td><a href="getting-started/harper-concepts.md">harper-concepts</a></td>
+        </tr>
+    </tbody>
+</table>

docs/getting-started/first-harper-app.md

@@ -30,39 +30,28 @@ The schema above does several important things:
 - Requires `title` and `author` fields (marked with `!`)
 - Adds optional `publishedYear` and `genre` fields
 
-When you start your application, Harper will automatically create this table structure.
+When you start your application, Harper will automatically create this table resource.
 
 ## Extend the Resource Class
 Now let's create the business logic for our Book API by implementing a custom resource class. Update your `resources.js` file:
 
 ```js
 export class Books extends Resource {
   // Get a book by ID or list all books
-  async get() {
+  get() {
     const id = this.getId();
 
     if (id) {
       // Return a single book
-      return await this.table.get(id);
+      return this.table.get(id);
     } else {
-      // Return all books with optional genre filter
-      const genre = this.getQueryParam("genre");
-      const searchOptions = genre ? { genre } : {};
-      return await this.table.search(searchOptions);
+      // Return all books
+      return this.table.get();
     }
   }
 
   // Create a new book
-  async post(data) {    
-    // Parse string data if needed
-    if (typeof data === "string") {
-      try {
-        data = JSON.parse(data);
-      } catch (err) {
-        return { error: "Invalid JSON" };
-      }
-    }
-    
+  post(data) {    
     // Validate required fields
     if (!data.title || !data.author) {
       return { error: "Title and author are required" };
@@ -72,8 +61,7 @@ export class Books extends Resource {
     if (data.id) delete data.id;
 
     try {
-      const result = await this.table.post(data);
-      return result;
+      return this.table.post(data);
     } catch (error) {
       return { error: "Error creating book", details: error.message };
     }
@@ -91,17 +79,13 @@ This line creates a custom `Books` class that extends Harper's built-in `Resourc
 
 ### GET Method
 ```js
-async get() {
+get() {
   const id = this.getId();
 
   if (id) {
-    // Return a single book
-    return await this.table.get(id);
+    return this.table.get(id);
   } else {
-    // Return all books with optional genre filter
-    const genre = this.getQueryParam("genre");
-    const searchOptions = genre ? { genre } : {};
-    return await this.table.search(searchOptions);
+    return this.table.get();
   }
 }
 ```
@@ -115,17 +99,7 @@ The `get()` method handles HTTP GET requests to our Book endpoint. It:
 
 ### POST Method
 ```js
-async post(data) {
-  
-  // Parse string data if needed
-  if (typeof data === "string") {
-    try {
-      data = JSON.parse(data);
-    } catch (err) {
-      return { error: "Invalid JSON" };
-    }
-  }
-  
+post(data) {
   // Validate required fields
   if (!data.title || !data.author) {
     return { error: "Title and author are required" };
@@ -134,12 +108,7 @@ async post(data) {
   // Prevent primary key overriding
   if (data.id) delete data.id;
 
-  try {
-    const result = await this.table.post(data);
-    return result;
-  } catch (error) {
-    return { error: "Error creating book", details: error.message };
-  }
+  return this.table.post(data);
 }
 ```
 

docs/getting-started/install-harper.md

@@ -3,7 +3,7 @@
 There are three ways to install a Harper instance: using a package manager like NPM, deploying it as a Docker container, and offline installation. Below is a step-by-step tutorial for each method.
 
 ## Installing via NPM
-Before you begin, ensure you have [Node.js](https://nodejs.org/) installed (v22 or newer is recommended). Node.js comes with npm, which will be used to install Harper.
+Before you begin, ensure you have [Node.js](https://nodejs.org/) LTS version or newer. Node.js comes with npm, which will be used to install Harper.
 
 Open your terminal or command prompt and install Harper globally by executing the command below. Installing globally allows the `harperdb` command to be accessible from anywhere on your machine, making it easier to manage multiple projects.