# Use and adapt kyna-docs

Use the documented interfaces and source layout for **kyna-docs**. The sections below retain the README’s examples and configuration details.

## Work locally

Requires Node.js 20 or newer.

```sh
npm install
npm start
```

The development server opens at `http://localhost:3000` and reloads when a page
changes.

## Verify a change

```sh
npm run build
npm run serve
```

`npm run build` checks routes and produces the static site in `build/`.

## Content structure

```text
docs/
  intro.mdx       overview and learning paths
  tutorial/       guided lessons
  reference/      language behavior and APIs
  stdlib/         standard-library modules
  examples.mdx    practical recipes
src/
  pages/          landing page
  components/     shared React components
  css/            site theme and responsive layout
```

Keep tutorials task-focused and explain one concept at a time. Put precise
language behavior in `reference/`, and standard-library APIs in `stdlib/`.

## Commands in the root manifest

The captured [package.json](https://github.com/Up-to-code/kyna-docs/blob/HEAD/package.json) declares the following scripts. Run them from the directory containing that manifest.

| Command | Script |
| --- | --- |
| `npm run start` | `docusaurus start` |
| `npm run build` | `docusaurus build` |
| `npm run serve` | `docusaurus serve` |

## Troubleshoot a local change

1. Reproduce the smallest example from the [quick-start guide](/docs/up-to-code-kyna-docs/quick-start-guide).
2. Compare required configuration and dependency versions with the README.
3. Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

## Source and help

- [GitHub repository](https://github.com/Up-to-code/kyna-docs)
- [Original README](https://github.com/Up-to-code/kyna-docs/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/kyna-docs/issues)