67fd73e6325c0bc80e4e6e27c4ef07246d89fce0
Guides/Getting-started.md
| ... | ... | @@ -1,14 +1,18 @@ |
| 1 | 1 | # Getting started |
| 2 | 2 | |
| 3 | -This page is generated from `wiki/templates/getting_started.md.erb`. Edit that file (or the manifest), then run: |
|
| 3 | +## For players — add a wiki page |
|
| 4 | 4 | |
| 5 | -```bash |
|
| 6 | -bundle exec rake wiki:generate |
|
| 7 | -``` |
|
| 5 | +1. Go to **[amascut.com](https://amascut.com)** and **sign up** or **log in** (same account as the site). |
|
| 6 | +2. Open **[amascut.com/wiki/new](https://amascut.com/wiki/new)** (from the site menu if linked, or type that URL). |
|
| 7 | +3. Write your page in **Markdown**, pick a **category**, and **submit**. It goes to staff as a **pending** edit. |
|
| 8 | +4. After an **admin approves** it, the page appears on this wiki under **Contributions/…** (for example `Contributions/general/your-page-id`). |
|
| 8 | 9 | |
| 9 | -Commit `wiki/content/` and deploy the Gollum image (see `wiki/README.md`). |
|
| 10 | +You **cannot** create pages directly on **wiki.amascut.com** — that site is read-only for everyone; submissions always go through **amascut.com**. |
|
| 10 | 11 | |
| 11 | 12 | ## Quick links |
| 12 | 13 | |
| 13 | 14 | - [Home](Home) |
| 14 | -- [Guides/Website-overview](Guides/Website-overview) |
|
| 15 | + |
|
| 16 | +--- |
|
| 17 | + |
|
| 18 | +*Staff:* this file is generated from `wiki/templates/getting_started.md.erb`. After edits, run `bundle exec rake wiki:generate`, commit `wiki/content/`, build/push the Gollum image (see `wiki/README.md`). |
Home.md
| ... | ... | @@ -1,5 +1,7 @@ |
| 1 | 1 | # Amascut Wiki |
| 2 | 2 | |
| 3 | +**[Create a page](https://amascut.com/wiki/new)** — sign in on the main site and submit a Markdown draft for staff review. |
|
| 4 | + |
|
| 3 | 5 | Welcome to the **player-run knowledge base** for the server: mechanics, guides, and notes the client does not spell out. |
| 4 | 6 | |
| 5 | 7 | **Official site:** [amascut.com](https://amascut.com) |
| ... | ... | @@ -9,10 +11,15 @@ Welcome to the **player-run knowledge base** for the server: mechanics, guides, |
| 9 | 11 | - [Guides/Getting-started](Guides/Getting-started) — first steps. |
| 10 | 12 | - Use the **search box** in the top bar (and **All pages** in the header menu) to find or start articles. |
| 11 | 13 | |
| 12 | -## Editing |
|
| 14 | +## Add or edit a page (players) |
|
| 15 | + |
|
| 16 | +The wiki at **wiki.amascut.com** is **read-only** in the browser. To contribute: |
|
| 17 | + |
|
| 18 | +1. **[Register or log in](https://amascut.com)** on the main site. |
|
| 19 | +2. Go to **[amascut.com/wiki/new](https://amascut.com/wiki/new)** and submit your draft (Markdown). |
|
| 20 | +3. Staff **approve** or **reject** it; if approved, it shows here under **Contributions/** (see [Guides/Getting-started](Guides/Getting-started) for detail). |
|
| 13 | 21 | |
| 14 | -- **Production:** The public wiki is **read-only**. To propose a change, create an account on **[amascut.com](https://amascut.com)** and use **Submit / edit** from the site wiki section (`/wiki/new`). An **admin must approve** your submission before it appears under **Contributions/…** on this wiki. |
|
| 15 | -- **Staff:** Manifest pages (**Home**, **Guides/**, etc.) are updated from the `amascut_web` git repo and Docker image (see `wiki/README.md`). |
|
| 22 | +**Staff:** Manifest pages (**Home**, **Guides/**, etc.) ship from the `amascut_web` git repo / Docker image (`wiki/README.md`). |
|
| 16 | 23 | |
| 17 | 24 | ## Suggested topics |
| 18 | 25 |
_Sidebar.md
| ... | ... | @@ -4,5 +4,3 @@ |
| 4 | 4 | |
| 5 | 5 | **Guides** |
| 6 | 6 | - [Getting started](Guides/Getting-started) |
| 7 | -- [Website & API overview](Guides/Website-overview) |
|
| 8 | -- [Monorepo layout](Guides/Repo-layout) |