docs: add a proper readme

Author: serhalp

README.md

@@ -1,54 +1,34 @@
 # Next.js Sentinel
 
-```sh
-npm create astro@latest -- --template basics
-```
+Monitor Next.js releases, analyze them with an LLM for relevance to Netlify,
 
-[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics)
-[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/basics)
-[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/basics/devcontainer.json)
+## Development
 
-> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+This is an Astro site.
 
-![just-the-basics](https://github.com/withastro/astro/assets/2244813/a0a5533c-a856-4198-8470-2d67b1d7c554)
+It stores Next.js release data in a Turso database.
 
-## 🚀 Project Structure
+It is deployed to Netlify.
 
-Inside of your Astro project, you'll see the following folders and files:
+It uses the PNPM package manager.
 
-```text
-/
-├── public/
-│   └── favicon.svg
-├── src/
-│   ├── components/
-│   │   └── Card.astro
-│   ├── layouts/
-│   │   └── Layout.astro
-│   └── pages/
-│       └── index.astro
-└── package.json
-```
-
-Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
-
-There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
-
-Any static assets, like images, can be placed in the `public/` directory.
-
-## 🧞 Commands
+### 🧞 Commands
 
 All commands are run from the root of the project, from a terminal:
 
-| Command                   | Action                                           |
-| :------------------------ | :----------------------------------------------- |
-| `npm install`             | Installs dependencies                            |
-| `npm run dev`             | Starts local dev server at `localhost:4321`      |
-| `npm run build`           | Build your production site to `./dist/`          |
-| `npm run preview`         | Preview your build locally, before deploying     |
-| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
-| `npm run astro -- --help` | Get help using the Astro CLI                     |
-
-## 👀 Want to learn more?
-
-Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
+| Command              | Action                                                     |
+| :------------------- | :--------------------------------------------------------- |
+| `pnpm install`       | Install dependencies                                       |
+| `pnpm run dev`       | Start local dev server at `localhost:4321`                 |
+| `pnpm run build`     | Build your production site to `./dist/`                    |
+| `pnpm run format`    | Format files with prettier                                 |
+| `pnpm run lint`      | Run ESLint                                                 |
+| `pnpm run typecheck` | Typecheck TypeScript files                                 |
+| `pnpm run test`      | Run all checks, including typechecking & eslint            |
+| `pnpm run preview`   | Preview your build locally, before deploying               |
+| `pnpm run migrate`   | Fetch recent releases, analyze them, and seed the database |
+
+### Contributing
+
+The release data is in a plain JSON file in `src/data/releases.json`. Feel free
+to send PRs with updates.