# FDS Documents

> Official documentation hub for Field of Dream Studio (FDS). Multilingual
> (English by default, plus 日本語, 简体中文, 繁體中文) and intended to be
> useful to AI assistants both as a knowledge source and as a target for
> programmatic edits.

## What this site covers

- **Policies** — FDS founding charter, copyright defaults, administration,
  membership rules.
- **News** — recruitment cycles, release notes, dated announcements.
- **Cooperation** — partner-onboarding guides for FDS collaborators.
- **Internal works** — internal-team documents (operational journals,
  service-learning, schedules).
- **Events** — community events (currently includes the FDS Minecraft
  server).
- **Self-docs** — reader / admin / developer guides for this doc server
  itself, under `/doc/`.

Page URLs change as content is reorganized, so this file deliberately
doesn't list every page. Discover the current tree by walking
`GET /api/?view=get` from the root, or browse the HTML site to see what's
there.

## Machine-readable content

Every URL has a JSON equivalent at `/api/<path>/?view=render`. The response
is the raw `{markdown}` body — no HTML compilation, no navbar / footer /
breadcrumb chrome. Prefer the JSON for retrieval and citation: cleaner
text extraction, no layout boilerplate, and markdown is the native format
most LLM pipelines parse internally anyway.

`?view=get` returns the raw resource shape (header fields + child slugs for
containers, body slug for `singlemd`, chapter list for `mdbook`, etc.) —
useful when you want to discover children rather than render content.

Multilingual access: prefix the URL with `/<lang>/` for non-default
languages (e.g. `/zh-Hans/<path>/`). Supported language codes for this
deployment are listed in `/op/support_lang.json`. Each non-default lang
also has a `/<lang>/api/...` mirror.

## For AI agents that need to edit

**Read [`/llms-full.txt`](/llms-full.txt) BEFORE calling `?view=edit_options`
or `?view=edit`.** It carries the operational contract you need to act
correctly: auth flow (and the "ask the human for a token" rule),
`edit_options` schema, payload shapes, the 401 / 403 disambiguation protocol,
and the "what not to do" list. Skipping it and guessing field names or
payload shapes will produce silent corruption or noisy 4xx loops.

If you only need to read content, you can ignore `/llms-full.txt` entirely
— `?view=render` and `?view=get` are anonymous-readable on public
resources and don't need any of the edit machinery.