## Reading the Docs

FDS Documents is the public documentation home for Field of Dreams Studio (FDS). It collects our organizational policies, information about partner sites and cooperation, announcements and news, and the guides for the doc server itself. The page you are reading right now is the readers' guide — a short tour of how to find your way around the site, switch languages, share links, and pull content down for offline use.

### How the site is organized

The home page shows two top-level groups. **FDS** holds the organization's own material: `policies`, `cooperation`, `news`, and `doc` (this documentation board). **Events** holds material tied to specific activities; at the moment it contains the **Minecraft Server** entry.

Every page has a breadcrumb trail at the very top. The last item in that trail is rendered as the page's heading, so you can always tell where you are at a glance, and click any earlier item to climb back up the tree.

Within a group, **board** pages show a grid of links into their sub-areas, while **list** pages link directly to individual articles. The news board is a chronological list, with the newest items first.

### Languages

Three languages are supported: **English** (default), **中文**, and **日本語**.

Use the language dropdown in the navbar to switch. The dropdown points at `/op/switch_lang/<code>`, which sets a language cookie and redirects you back to the page you were reading in the new language.

URLs come in two forms:

- **Bare** URLs such as `/policies/` follow your language cookie. First-time visitors with no cookie set get English.
- **Prefixed** URLs such as `/zh/policies/` or `/ja/policies/` pin a language explicitly. Search engines crawl the prefixed forms, so each language is independently indexed and discoverable.

The admin and developer guides under `/doc/` are intentionally English-only. Their content references code paths, configuration keys, and other identifiers that don't translate cleanly. Their titles and descriptions still localize, so they appear correctly in board listings in your language.

### Sharing links

Any URL on the site is shareable as-is. If you want to make sure the recipient sees the page in a specific language regardless of their own cookie, share the prefixed form — for example `/zh/news/` to pin Chinese, or `/ja/news/` for Japanese.

### Downloading content

Append `?view=download` to almost any page URL to get its content as a file:

- On a `singlemd` page (a single-article doc), you get the markdown source as a `.md` attachment.
- On an `mdbook` page (a multi-chapter book), you get a `.zip` containing every chapter's markdown in reading order.
- On a file page, you get the original uploaded bytes under the original filename.

Downloads obey the same read permission as the page itself — if you can view the page in your browser, you can download it.

### Search and discovery

A full-text search is not yet available. For now, browse through the section index pages: the board and list views are designed to make the site walkable from the home page down to any individual article.

### Feedback

For organizational questions or general feedback about FDS, visit the main site at [https://fds.moe](https://fds.moe). Issues specific to the doc server are tracked in its development repository — see the developer guide for details.