| | # How to edit |
| | |
| | The ALB wiki is written by its readers — **anyone can edit any page, no account needed**. Click the **Edit** tab on any article, change the text, write a short summary, and hit **Save page**. Your change is live immediately and kept in the page's history forever. |
| | |
| | > Be bold. If you see something wrong or missing, fix it — you can't break anything, every old revision is kept. |
| | |
| | ## Markup |
| | |
| | The wiki uses Markdown plus wiki-style `[[links]]`: |
| | |
| | | What you want | What you type | |
| | | --- | --- | |
| | | Headings | `# Title`, `## Section`, `### Part` | |
| | | Bold / italic | `**bold**`, `*italic*` | |
| | | Inline code | `\`PRINT\`` | |
| | | Code block | a fenced block starting and ending with `\`\`\`` | |
| - | | Bullet list | `- item` | |
| + | | Bullet list | `- item` or `* item` | |
| | | Numbered list | `1. item` | |
| | | Quote | `> words` | |
| | | Internal link | `[[Page name]]` or `[[Page name|shown text]]` | |
| | | Category | `[[Category:Name]]` anywhere in the page | |
| | | External link | `[label](https://example.org)` | |
| | | Horizontal rule | `---` on its own line | |
| + | | Table | rows separated by `\|` (see below) | |
| | |
| | ## Links |
| | |
| | Internal links are the wiki's connective tissue. Type `[[Getting Started]]` and the wiki links it automatically: |
| | |
| | - **Blue links** go to pages that exist. |
| | - **Red links** go to pages that *don't* exist yet — click one to create it. Red links are invitations, not errors. |
| | - Use `[[AdaLogic BASIC|the language]]` to show different text than the page name. |
| + | - **Links work inside headings too** — `### [[Jacquard Loom|The Jacquard loom (1801–1804)]]` makes the whole heading a link, which is how section titles point to their own articles. |
| | |
| + | ## Tables |
| + | |
| + | Tables use pipe rows: |
| + | |
| + | ``` |
| + | | Name | Born | Known for | |
| + | | --- | --- | --- | |
| + | | [[Ada Lovelace]] | 1815 | The first published program | |
| + | | [[Alan Turing]] | 1912 | The universal machine | |
| + | ``` |
| + | |
| + | The `---` row under the header separates it from the body. External links work inside cells. |
| + | |
| | ## Categories |
| | |
| - | Put `[[Category:Reference]]` anywhere in a page's text to file it. The category box appears at the bottom, and the page shows up automatically at `[[Category:Reference]]`'s listing. Categories are created just by being used — no setup needed. |
| + | Put `[[Category:History]]` anywhere in a page's text to file it. The category box appears at the bottom, and the page shows up automatically on that category's listing. Categories are created just by being used — no setup needed. |
| | |
| + | Current categories include `Language`, `History`, `People`, `Hardware`, `Languages`, `Companies`, `Mathematics`, `Reference`, `Wiki`, and `Help` — but anyone can start a new one. |
| + | |
| | ## History, diffs, and reverting |
| | |
| | - The **History** tab lists every revision ever made — who, when, and the summary. |
| - | - Click **diff** next to any revision to see exactly what changed. |
| + | - Click **diff** next to any revision to see exactly what changed, word by word. |
| | - Click **revert** to restore an older revision. A revert is itself a new revision — history is never destroyed, and vandalism can be undone by anyone in seconds. |
| | |
| + | ## Finding pages |
| + | |
| + | - **Search** (top of every wiki page) finds text in titles and bodies. |
| + | - **Special:AllPages** lists every article alphabetically. |
| + | - **Special:RecentChanges** shows the latest edits across the whole wiki. |
| + | |
| | ## Good pages to write |
| | |
| - | This wiki's first subject is **[[AdaLogic BASIC]]**. Great contributions include: |
| + | This wiki has two growing halves, and both want new pages: |
| | |
| - | - Language reference pages — one page per statement or function |
| + | **The ALB reference** — language documentation: |
| + | - One page per statement, function, or keyword |
| | - Tutorials and worked examples |
| | - Patterns and idioms — how to structure an ALB program |
| - | - Gotchas, pitfalls, and frequently asked questions |
| + | - Gotchas, pitfalls, frequently asked questions |
| | - Glossary pages for terms beginners meet |
| | |
| + | **The history encyclopedia** — the story of programming, already underway: |
| + | - People: [[Ada Lovelace]], [[Alan Turing]], [[John von Neumann]], [[Herman Hollerith]], [[Joseph-Marie Jacquard]], the [[The first programmers|ENIAC six]] |
| + | - Machines and documents: [[Jacquard Loom]], [[Analytical Engine]], [[EDVAC report]], [[Manchester Baby]], [[EDSAC]], [[IBM]] |
| + | - Languages: [[FORTRAN]], [[LISP]], [[ALGOL]] |
| + | - Red links everywhere are the to-do list — pick one and write it. |
| + | |
| | ## Style notes |
| | |
| | * **Keep it family-friendly** — this is a learning site. |
| | * Write plainly and factually; teach, don't advertise. |
| | * Prefer short sections with headings over one wall of text. |
| + | * Link generously — every proper name, machine, and language in a sentence deserves a `[[link]]`, even if it's red. |
| | * Code examples should be real, working ALB. |
| | * Always fill in the **summary** line — it makes Recent Changes and History readable. |
| | |
| | ## House rules |
| | |
| | * Edits are public immediately — don't post private information. |
| | * Pages can be protected and edits logged; spam and vandalism get reverted quickly. |
| | * Anonymous edits are attributed "Anonymous"; signed-in members get credited by username. |
| | |
| | [[Category:Wiki]] |
| | [[Category:Help]] |
| + | |
