Proposal: Restructure Janet's Documentation

README.md

@@ -63,13 +63,10 @@ should give the output:
 array_47new.janet
 ```
 
-If such a file already exists, you can simply append your example code
-to the existing file.
-
-When building the site, the new examples will be included in the
-generated documentation. Make sure that your example has correct janet
-syntax, as syntax errors will cause the entire site to not build. If
-the example has valid syntax (has a 0 exit code when loaded with
-`janet -k example/my-fn.janet`), there may be a bug in the mendoza
-janet syntax highlighter in which case please open a bug in mendoza.
+If such a file already exists, you can simply append your example code the existing file.
 
+When building the site, the new examples will be included in the generated documentation. Make
+sure that your example has correct janet syntax, as syntax errors will cause the entire site
+to not build. If the example has valid syntax (has a 0 exit code when loaded with
+        `janet -k example/my-fn.janet`), there may be a bug in the mendoza janet syntax
+highlighter and you open a bug in mendoza.

content/api/array.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Array Module"
  :nav-title "array"

content/api/buffer.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Buffer Module"
  :nav-title "buffer"

content/api/bundle.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Bundle Module"
  :nav-title "bundle"

content/api/debug.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Debug Module"
  :nav-title "debug"

content/api/ev.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Event Module"
  :nav-title "ev"

content/api/ffi.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "FFI Module"
  :nav-title "ffi"

content/api/fiber.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Fiber Module"
  :nav-title "fiber"

content/api/file.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "File Module"
  :nav-title "file"

content/api/filewatch.mdz

@@ -0,0 +1,10 @@
+(import ../gen-docs :as gen-docs)
+
+{:title "Filewatch Module"
+ :nav-title "filewatch"
+ :template "docpage.html"}
+---
+
+## Index
+
+@gen-docs/gen-prefix[filewatch/]

content/api/index.mdz

@@ -1,7 +1,7 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Core API"
- :nav-title "API"
+ :nav-title "Core API"
  :order 3
  :template "docpage.html"
  :permalinks ["doc.html"] }

content/api/int.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Integer Types Module"
  :nav-title "int"

content/api/janet.mdz

@@ -0,0 +1,11 @@
+(import ../gen-docs :as gen-docs)
+
+{:title "Janet Module"
+ :nav-title "janet"
+ :template "docpage.html"}
+---
+
+## Index
+
+@gen-docs/gen-prefix[janet/]
+

content/api/math.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Math Module"
  :nav-title "math"

content/api/misc.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Top Level Bindings"
  :nav-title "misc"

content/api/module.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Module Module"
  :nav-title "module"

content/api/net.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Net Module"
  :nav-title "net"

content/api/os.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "OS Module"
  :nav-title "os"

content/api/parser.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "Parser Module"
  :nav-title "parser"

content/api/peg.mdz

@@ -1,4 +1,4 @@
-(import ./gen-docs :as gen-docs)
+(import ../gen-docs :as gen-docs)
 
 {:title "PEG Module"
  :nav-title "peg"