namespaces added and documentation

README.md

@@ -1,8 +1,8 @@
 # racket-wiki
 
-Version 0.2.30 tightens implicit wiki links to classic WikiWords: only letter-only CamelCase words with at least two capitalized word segments are treated as implicit links. Version-like identifiers and words containing digits or punctuation are not WikiWords.
+Version 0.2.31 adds page namespaces as database metadata and extends wiki references to forms such as `RWS:ModelTreeWalker` and `[roadmap](racket:roadmap)`. Todo items and bookmarks are grouped by namespace. The source has also been documented more thoroughly, especially `static/js/wiki.js`.
 
-Current development version: **0.2.29**.
+Current development version: **0.2.31**.
 
 A small self-hosted wiki with a Racket backend and an HTML5/CSS/JavaScript frontend.
 
@@ -198,6 +198,33 @@ When the site is served through HTTPS, add `--secure-cookie` so the session cook
 
 The `--create-admin` command-line option remains available for recovery or scripted administration, but it is no longer part of the normal first-run procedure.
 
+
+## Page namespaces
+
+Every page has a namespace and a page slug. Existing pages are migrated to the root namespace. The external page reference is compact:
+
+```text
+roadmap
+racket:roadmap
+RWS:model-tree-walker
+```
+
+The editor exposes the namespace as page metadata. The slug is still generated from the title when a page is first created and remains stable afterwards. The combination of namespace and slug is unique in PostgreSQL.
+
+Explicit Markdown links may use the compact form directly:
+
+```markdown
+[roadmap](racket:roadmap)
+```
+
+Classic WikiWords may also be namespace-qualified:
+
+```text
+RWS:ModelTreeWalker
+```
+
+The WikiWord portion still follows the strict letter-only classic rule. Todo and Bookmark views group their entries by namespace; bookmark user sections remain available as a second grouping level.
+
 ## Editing
 
 EasyMDE supplies the Markdown editor, Markdown-aware styling while editing, line numbers, keyboard shortcuts, preview, side-by-side mode and fullscreen mode. On a normal desktop-sized window racket-wiki opens the editor in side-by-side mode by default. EasyMDE is configured with `sideBySideFullscreen: false`, so split editing remains inside the normal wiki page rather than taking over the complete browser window.