Make example links work.

This seems to have been using a more complex form of linking,
but just switch to the simple form used in most places as it
works and is easier to understand.

Author: handrews

examples.md

@@ -12,13 +12,15 @@ Here is a basic example of a JSON Schema:
 Example schemas
 ---------------
 
-These sample schemas describe simple data structures which can be expressed as JSON:
+These sample schemas describe simple data structures which can be expressed as JSON.  The "canonical url" links omit the ".json" extension, which is the correct
+way to reference the schema in a ``$ref``, but is not friendly to web browsers.
+The larger links use ".json" for browser compatibility.
 
 |------------------------------------------------------------------------------|-----------------------------------------------------------------|
-| [Geographic Coordinate][geo.json] <br> [<small>(canonical url)</small>][geo] | a ___location as longitude and latitude                            |
-| [Card][card.json] <br> [<small>(canonical url)</small>][card]                | a microformat-style representation of a person, company, organization, or place |
-| [Calendar][cal.json] <br> [<small>(canonical url)</small>][cal]              | a microformat-style representation of an event                  |
-| [Address][addr.json] <br> [<small>(canonical url)</small>][addr]             | a microformat-style representation of a street address          |
+| [Geographic Coordinate](geo.json) <br> [<small>(canonical url)</small>](geo) | a ___location as longitude and latitude                            |
+| [Card](card.json) <br> [<small>(canonical url)</small>](card)                | a microformat-style representation of a person, company, organization, or place |
+| [Calendar](cal.json) <br> [<small>(canonical url)</small>](cal)              | a microformat-style representation of an event                  |
+| [Address](addr.json) <br> [<small>(canonical url)</small>](addr)             | a microformat-style representation of a street address          |
 
 Walkthroughs
 ------------
@@ -29,13 +31,3 @@ The two examples below are step-by-step guides into building a schema:
 -   [a more advanced example](example2.md), using JSON Schema to describe filesystem entries in a Unix-like /etc/fstab file.
 
 The [Space Telescope Science Institute](http://www.stsci.edu/) has also published a [guide aimed at schema authors](http://spacetelescope.github.io/understanding-json-schema/).
-
-
-[geo.json]: example/geo.json
-[card.json]: example/card.json
-[cal.json]: example/calendar.json
-[addr.json]: example/address.json
-[geo]: geo
-[card]: card
-[cal]: calendar
-[addr]: address