add links to docs

docs/webapp/permanent-url/index.rst

@@ -7,21 +7,19 @@ They are based on class names combined with local IDs provided by the data resou
 
 In FlyMine, for example, the URL of the report page for the gene zen, with primary identifier P19107, will be http://flymine.org/gene:FBgn0004053.
 
-They are used to share the report page with other users.
+These URLs are used to share the report page with other users.
 
 .. image:: img/share.png
 
 The :doc:`class_keys.properties </webapp/properties/class-keys/>` file specifies the keys used to generate the permanent URLs. If not specified, the primaryidentifier key is used.
 
 The format is:
 
-=============== ================
-key             value
-=============== ================
-<CLASSNAME>_URI <FIELDNAME>
-=============== ================
+.. code-block:: property
+
+    <CLASSNAME>_URI <FIELDNAME>
 
-The classes and fields are case sensitive.
+The classes and field names are case sensitive.
 
 For example:
 
@@ -33,6 +31,6 @@ Organism_URI    taxonId
 Publication_URI pubMedId
 =============== ================
 
-See :doc:`/webapp/properties/class-keys` for details.
+See :doc:`/webapp/properties/class-keys` for details about this file.
 
 .. index:: permanent URL

docs/webapp/properties/class-keys.rst

@@ -19,6 +19,6 @@ Given the above configuration, in FlyMine, the URL of the report page for the pr
 
 See :doc:`/webapp/permanent-url/index` for details on permanent URLs.
 
-See FlyMine's class keys for an example.
+See `FlyMine's class keys <https://github.com/intermine/flymine/blob/master/dbmodel/resources/class_keys.properties>`_ for an example file.
 
 .. index:: class keys, list upload classes