Skip to content

Making compute focused updates to the Application documentation#166

Closed
sludin wants to merge 1 commit into
mainfrom
Ludin_Doc_Update
Closed

Making compute focused updates to the Application documentation#166
sludin wants to merge 1 commit into
mainfrom
Ludin_Doc_Update

Conversation

@sludin

@sludin sludin commented Apr 11, 2025

Copy link
Copy Markdown

No description provided.

@kriszyp kriszyp left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a ton of fantastic content in here. We should use it.
However, I still believe that for introducing users to Harper, we should prioritize showing the simplest and easiest path from installation to writing data and querying it so they can so how easily they can get started. They shouldn't have to write JavaScript before they can do a simple query, and the introduction should help users to see the powerful OOTB functionality before they start trying to customize it.
But after that, I think this provides tons of great examples of how to config files are structured, how that works, and how to build custom endpoints.
Including @nenharper as well here because this page is really the main content for the future getting started guide.

```graphql
type Dog @table {
# properties will go here soon
type Dogs @table {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My understanding is that it is the Harper standard to use singular names for tables, not plural (I didn't define that standard, just followed it).

If you are using Harper Studio, we can now [add JSON-formatted records](../../administration/harper-studio/manage-databases-browse-data.md#add-a-record) to this new table in the studio or upload data as [CSV from a local file or URL](../../administration/harper-studio/manage-databases-browse-data.md#load-csv-data). A third, more advanced, way to add data to your database is to use the [operations API](../operations-api/), which provides full administrative control over your new Harper instance and tables. We are going to use a fourth method, the capabilties exposed by the built-in`rest` extension, in the next section.

## Adding an Endpoint
## Adding a Endpoint with REST

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You no like English?! 😆

@kriszyp kriszyp closed this Jul 30, 2025
@Ethan-Arrowood Ethan-Arrowood deleted the Ludin_Doc_Update branch August 12, 2025 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants