update README and generate invalid links

Author: citelao

README.md

@@ -54,10 +54,23 @@ To get a feel for how Moxygen works you can play with the example which is locat
 * Pre-generated XML output in [example/xml](/example/xml)
 * Pre-generated output Markdown files in [example/doc](/example/doc)
 
-The rebuild the example XML you can run `doxygen` from within the example folder.
+To fully build the example, follow these steps (once you've installed `doxygen`. See **Development & Contribution**, below):
 
-Now you can build the example documentation with the following command from within the example folder:
+1. Rebuild the XML: run `doxygen` from within the example folder.
+2. Rebuild the Moxygen output: from within this directory,
 
 ```
-moxygen --anchors --groups --output=example/doc/api-%s.md example/xml
+node bin/moxygen.js --groups --pages --anchors --output=example/doc/api-%s.md example/xml
 ```
+
+## Development & Contribution
+
+You can develop this project as you would any other Node project:
+
+1. Clone this repo.
+2. `npm install` from this directory.
+
+This project is tested through integration, by building the `example/`. To quickly test this project:
+
+1. Install `doxygen` (`brew install doxygen`, `choco install doxygen`, for example). Only must be done once per computer.
+2. `npm test` from this directory. This will run Doxygen on the `example/` and build the output.

example/doc/api-mountainbike.md

@@ -6,7 +6,7 @@ Mountain bike module contains the `MountainBike` class. Mountain bikes are a kin
 
  Members                        | Descriptions                                
 --------------------------------|---------------------------------------------
-`class `[`transport::MountainBike`](#classtransport_1_1MountainBike) | Mountain bike implementation of a `[Bicycle](./api-bicycle.md#classtransport_1_1Bicycle)`.
+`class `[`transport::MountainBike`](#classtransport_1_1MountainBike) | Mountain bike implementation of a `[Bicycle](example/doc/api-bicycle.md#classtransport_1_1Bicycle)`.
 
 # class `transport::MountainBike` {#classtransport_1_1MountainBike}
 
@@ -15,9 +15,9 @@ class transport::MountainBike
   : public transport::Bicycle
 ```  
 
-Mountain bike implementation of a `[Bicycle](./api-bicycle.md#classtransport_1_1Bicycle)`.
+Mountain bike implementation of a `[Bicycle](example/doc/api-bicycle.md#classtransport_1_1Bicycle)`.
 
-[MountainBike](#classtransport_1_1MountainBike) is an implementation of a [Bicycle](./api-bicycle.md#classtransport_1_1Bicycle) providing a bike for cycling on rough terrain. Mountain bikes are pretty cool because they have stuff like **Suspension** (and you can even adjust it using SetSuspension). If you're looking for a bike for use on the road, you might be better off using a [RacingBike](./api-racingbike.md#classtransport_1_1RacingBike) though.
+[MountainBike](#classtransport_1_1MountainBike) is an implementation of a [Bicycle](example/doc/api-bicycle.md#classtransport_1_1Bicycle) providing a bike for cycling on rough terrain. Mountain bikes are pretty cool because they have stuff like **Suspension** (and you can even adjust it using SetSuspension). If you're looking for a bike for use on the road, you might be better off using a [RacingBike](example/doc/api-racingbike.md#classtransport_1_1RacingBike) though.
 
 ## Summary
 

example/doc/page-md_src_overview.md

@@ -1,6 +1,6 @@
 # page `md_src_overview` {#md_src_overview}
 
-The `transport` namespace provides several differnt types of bycicles, including [transport::Bicycle](./api-bicycle.md#classtransport_1_1Bicycle), [transport::MountainBike](./api-mountainbike.md#classtransport_1_1MountainBike) (designed for rough terrain), and [transport::RacingBike](./api-racingbike.md#classtransport_1_1RacingBike) (designed specifically for challenging races).
+The `transport` namespace provides several differnt types of bycicles, including [transport::Bicycle](example/doc/api-bicycle.md#classtransport_1_1Bicycle), [transport::MountainBike](example/doc/api-mountainbike.md#classtransport_1_1MountainBike) (designed for rough terrain), and [transport::RacingBike](example/doc/api-racingbike.md#classtransport_1_1RacingBike) (designed specifically for challenging races).
 
 ## Changelog
 

package.json

@@ -5,7 +5,7 @@
   "main": "index.js",
   "scripts": {
     "release": "release-it",
-    "test": "cd example/ && doxygen && cd doc/ && node ../../bin/moxygen.js ../xml -o ./api-%s.md --groups --pages --anchors"
+    "test": "cd example/ && doxygen && cd .. && node bin/moxygen.js --groups --pages --anchors --output=example/doc/api-%s.md example/xml"
   },
   "bin": {
     "moxygen": "./bin/moxygen.js"