Fix links to php file extensions and update front page

README.md

@@ -1,75 +1,104 @@
 AMEEconnect Documentation (v3)
 ==============================
 
-This is the documentation for AMEEconnect, API version 3, written in Markdown. 
-For version 2 documentation, please check out the v2_maintenance branch.
+Welcome to the AMEE Connect API documentation.
 
-This work is licensed under a [Creative Commons Attribution-ShareAlike 3.0 Unported License](http://creativecommons.org/licenses/by-sa/3.0/).
+API version 3.6
+---------------
+
+* * * * *
+
+**Table of Contents**
+
+[Introduction](sections/introduction.md)
+
+[About This Manual](sections/introduction.md#about)
+
+[Before You Start](sections/introduction.md#before-you-start)
+
+[API Versions](sections/introduction.md#api-versions)
+
+[Quick Start](sections/quickstart.md)
+
+[Getting Started](sections/quickstart.md#getting-started)
+
+[Choose Your Model](sections/quickstart.md#quick-choose-data-item)
+
+[Do the Calculation](sections/quickstart.md#quick-do-calculation)
+
+[Get Emission Factors](sections/data.md)
+
+[Models and Contexts](sections/data.md#models)
+
+[Using AMEEdiscover](sections/data.md#ameediscover)
 
-Requirements
-------------
+[Fetching Emission Factors](sections/data.md#get-data-items)
 
-On OSX:
+[Perform Calculations](sections/calculations.md)
 
-* XCode or the XCode command line tools
-* Homebrew
-* RVM with Ruby 1.9.2
+[Doing a Calculation](sections/calculations.md#doing-calculations)
 
-Then:
+[Getting Results](sections/calculations.md#getting-results)
 
-    > brew install docbook fop
-    > bundle
+[Store Data](sections/profiles.md)
 
-Manual Builds
--------------
+[Using AMEEconnect to Store Data](sections/profiles.md#store-data)
 
-    > make [TARGET]
+[Creating a Profile](sections/profiles.md#create-profile)
 
-standard targets:
+[Storing Inputs](sections/profiles.md#create-profile-item)
 
-* `html-chunk`: HTML multi page, generally used in development
-* `php-chunk`:  PHP multi page for use in AMEE's wordpress site (this is the default)
+[Fetching Return Values](sections/profiles.md#retrieve-items)
 
-other targets (used less often, and may not currently work properly):
+[List Stored Profile Items](sections/profiles.md#list-items)
 
-* `pdf`:  single PDF
-* `html`: single page HTML
+[Building Time Series](sections/profiles.md#build-time-series)
 
-Deploying to the live site
---------------------------
+[Naming Profile Items](sections/profiles.md#naming-items)
 
-    > make
-	> cap {staging|production} deploy
+[Time Series Queries](sections/profiles.md#time-series-queries)
 
-Regenerating Samples
---------------------
+[Advanced Options](sections/advanced.md)
 
-First time only:
+[Specifying API Version](sections/advanced.md#specifying-api-versions)
 
-	> cp src/doc/samples/amee.example.yml src/doc/samples/amee.yml
-	> vi src/doc/samples/amee.yml
+[Units](sections/advanced.md#units)
 
-Every time:
+[Matrix Parameters](sections/advanced.md#matrix-parameters)
 
-    > make samples
+[Search](sections/advanced.md#search)
 
-To add new samples, edit src/doc/samples/Rakefile and add a new request. Then include the generated 
-file from the samples directory, which will include the XML and JSON variants automatically.
+[Authority](sections/advanced.md#authority)
 
-Automated Builds
-----------------
+[Paging](sections/advanced.md#paging)
 
-From the root directory, run:
+[Interactive Context Selection](sections/advanced.md#interactive-drilldowns)
 
-    > guard
+[AMEEconnect API reference](sections/reference.md)
 
-This should set up automatic building of the html-chunk documentation. A config.ru file is 
-included so you can view it with pow.cx if you want to (may be useful for livereload, though
-I've not set that up yet).
+[Models](sections/reference.md#data-category-reference)
 
-Editing
--------
+[Contexts](sections/reference.md#data-item-reference)
 
-Edit the individual files in src/doc to change text. src/doc/translations.ent contains shared
-HTML entites for common terms, to make changing them across the entire document simple. To change
-layout or container content for any of the builds, see the XSL stylesheets in src/stylesheets.
+[Emission Factors](sections/reference.md#data-item-value-reference)
+
+[Profiles](sections/reference.md#profile-reference)
+
+[Profile Items](sections/reference.md#profile-item-reference)
+
+[Batch Operations](sections/reference.md#batch-operations-reference)
+
+[Search](sections/reference.md#search-reference)
+
+[Authentication](sections/reference.md#auth-reference)
+
+[UIDs](sections/reference.md#uid-reference)
+
+[Date and Time Representation](sections/reference.md#date-reference)
+
+[References](sections/bib.md)
+
+
+
+
+This work is licensed under a [Creative Commons Attribution-ShareAlike 3.0 Unported License](http://creativecommons.org/licenses/by-sa/3.0/).

sections/bib.md

@@ -15,4 +15,4 @@ Goessner.
 [4] *[XPath Tutorial](http://www.w3schools.com/xpath/default.asp)*.
 W3Schools.
 
-  [« AMEEconnect API reference](reference.php) | [Contents](index.php)
+  [« AMEEconnect API reference](reference.md) | [Contents](index.md)

sections/calculations.md

@@ -101,4 +101,4 @@ equivalent amount of CO2 that would have the same climate impact, along with oth
 
 Any notes or errors returned by the calculation will also be included in the response. These provide context or explanation of what the calculation is doing, or what was wrong in the event of an input error.
 
-[« Get Emission Factors](data.md) | [Contents](index.md) | [Store Data »](profiles.md)
+[« Get Emission Factors](data.md) | [Contents](index.md) | [Store Data »](profiles.md)

sections/index.md

@@ -92,9 +92,3 @@ API version 3.6
 [Date and Time Representation](reference.md#date-reference)
 
 [References](bib.md)
-
-* * * * *
-
-[Introduction »](introduction.md)
-
-

sections/introduction.md

@@ -1,11 +1,11 @@
 Introduction
 ------------
 
-[About This Manual](introduction.php#about)
+[About This Manual](introduction.md#about)
 
-[Before You Start](introduction.php#before-you-start)
+[Before You Start](introduction.md#before-you-start)
 
-[API Versions](introduction.php#api-versions)
+[API Versions](introduction.md#api-versions)
 
 About This Manual
 -----------------
@@ -28,12 +28,11 @@ API Versions
 ------------
 
 This manual only covers version 3.6 of the AMEEconnect API. For details of API versioning, see [the section called “Specifying API
-Version”](advanced.php#specifying-api-versions "Specifying API Version").
+Version”](advanced.md#specifying-api-versions "Specifying API Version").
 
 If you require documentation for previous versions please refer to the
 links below:
 
 -   [API Version 2](/developer/docs/v2)
 
-[« AMEEconnect Documentation](index.php) | [Contents](index.php) | [Quick Start »](quickstart.php)
-
+[« AMEEconnect Documentation](index.md) | [Contents](index.md) | [Quick Start »](quickstart.md)

sections/quickstart.md

@@ -145,4 +145,4 @@ more you can do with it, whether you want to just grab the emission
 factors, or build up complex histories over time.
 
 
-  [« Introduction](introduction.php) |   [Contents](index.php) | [Get Emission Factors »](data.php)
+  [« Introduction](introduction.md) |   [Contents](index.md) | [Get Emission Factors »](data.md)