Seems a find/replace has taken out a number of - and replaced them with *. Bullet points back to using *. Sorry shouldn't have changed that.

Change-log.md

@@ -6,7 +6,7 @@ Please note all dates are expressed as [ISO-8601](http://en.wikipedia.org/wiki/I
 
 ## New Features:
 
-- `[/vep]` output has been changed to be more json compliant and hierarchic
+* `[/vep]` output has been changed to be more json compliant and hierarchic
 
 # 2.0.0 - 2014/06/26
 
@@ -14,34 +14,34 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- New POST endpoints. POST messages allow the user to potentially submit huge quantities of requests, so please be kind, observe any rate and message size limits, and make your clients tolerant to timeouts and errors.
-  - `[/vep/:species/id/]`, `[/vep/:species/region/]`. The VEP endpoints have had their URLs altered, and the existing ID and region endpoints now accept POST messages containing many variants. Regions can be submitted in the [formats supported by the VEP](http://www.ensembl.org/info/docs/tools/vep/vep_formats.html) (vcf, hgvs, pileup, ensembl, and vep).
-  - `[/archive/id/]`. The archive endpoint now supports lists of IDs in POST messages.
-- `[/variation]` endpoint that retrieves variants linked to a gene or transcript
-- `[/genetree/*]` endpoints support JSON response format
-- `[/feature/*]` endpoints renamed to `[/overlap/]` to more closely represent their function
-- `[/overlap/*]` endpoints now support BED response format
-- `[/sequence/*]` endpoints now report sequence with contextual soft-masking for features through the `mask_feature` option. This allows the finding of feature boundaries in raw sequence. IDs of type `cds` mask the UTRs, and IDs of type `gene` mask introns.
-- HTTPS support for clients working within a secure environment
-- The rate limiter is set to 15 requests per second (an increase from 3)
+* New POST endpoints. POST messages allow the user to potentially submit huge quantities of requests, so please be kind, observe any rate and message size limits, and make your clients tolerant to timeouts and errors.
+  * `[/vep/:species/id/]`, `[/vep/:species/region/]`. The VEP endpoints have had their URLs altered, and the existing ID and region endpoints now accept POST messages containing many variants. Regions can be submitted in the [formats supported by the VEP](http://www.ensembl.org/info/docs/tools/vep/vep_formats.html) (vcf, hgvs, pileup, ensembl, and vep).
+  * `[/archive/id/]`. The archive endpoint now supports lists of IDs in POST messages.
+* `[/variation]` endpoint that retrieves variants linked to a gene or transcript
+* `[/genetree/*]` endpoints support JSON response format
+* `[/feature/*]` endpoints renamed to `[/overlap/]` to more closely represent their function
+* `[/overlap/*]` endpoints now support BED response format
+* `[/sequence/*]` endpoints now report sequence with contextual soft-masking for features through the `mask_feature` option. This allows the finding of feature boundaries in raw sequence. IDs of type `cds` mask the UTRs, and IDs of type `gene` mask introns.
+* HTTPS support for clients working within a secure environment
+* The rate limiter is set to 15 requests per second (an increase from 3)
 
 ## Bugfixes:
 
-- Spelling of `[/ontology/descendents]` changed to `[/ontology/descendants]`
-- Documentation overhaul to better explain endpoints and parameters
-- Regulatory features appear correctly from `[/overlap/*]` endpoints
-- Numerous tweaks to error handling and documentation
-- `[/assembly/info]` renamed to `[/info/assembly]` to match convention
+* Spelling of `[/ontology/descendents]` changed to `[/ontology/descendants]`
+* Documentation overhaul to better explain endpoints and parameters
+* Regulatory features appear correctly from `[/overlap/*]` endpoints
+* Numerous tweaks to error handling and documentation
+* `[/assembly/info]` renamed to `[/info/assembly]` to match convention
 
 ## Retirements:
 
-- MessagePack and Sereal formats were receiving little use and have been retired to decrease maintenance burden
-- `[/genetree/*]` endpoints no longer supporting phyloxml_aligned and phyloxml_sequence parameters. These have been replaced with aligned and sequence.
-- `[/location]` endpoints have been replaced by `[/overlap]`
+* MessagePack and Sereal formats were receiving little use and have been retired to decrease maintenance burden
+* `[/genetree/*]` endpoints no longer supporting phyloxml_aligned and phyloxml_sequence parameters. These have been replaced with aligned and sequence.
+* `[/location]` endpoints have been replaced by `[/overlap]`
 
 ## Deployment issues:
 
-- New versions of Moose, Catalyst and Catalyst::Action::REST are causing misbehaviour with the server. Please observe the library versions required in the installation makefile until we find a way to fix this conflict.
+* New versions of Moose, Catalyst and Catalyst::Action::REST are causing misbehaviour with the server. Please observe the library versions required in the installation makefile until we find a way to fix this conflict.
 
 ---
 
@@ -49,15 +49,15 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- `[/feature/]` Trim features from output which overlap 5' or 3' optionally
-- `[/alignment/region/]` replaces `[/alignment/block/region/]` and `[/alignment/slice/region/]`
+* `[/feature/]` Trim features from output which overlap 5' or 3' optionally
+* `[/alignment/region/]` replaces `[/alignment/block/region/]` and `[/alignment/slice/region/]`
 
 ## Bugfixes:
 
-- The example for multiple alignments is wrong
-- XS assert_ref fails with REST feature endpoint
-- `[/feature]` BED output is very slow for transcripts
-- `[/feature]` BED output; thick and thin ends are incorrect for reverse strand transcripts
+* The example for multiple alignments is wrong
+* XS assert_ref fails with REST feature endpoint
+* `[/feature]` BED output is very slow for transcripts
+* `[/feature]` BED output; thick and thin ends are incorrect for reverse strand transcripts
 
 ---
 
@@ -65,29 +65,29 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Bugfixes:
 
-- Removed deprecated methods from Compara
+* Removed deprecated methods from Compara
 
 # 1.5.0 - 2013/12/04
 
 ## New Features:
 
-- Build a better rate limiter
-- Enable compression on REST site
-- Ensure rate limiter reports the time scale over which rate limiting occurs
-- Faster GeneTree serlialisation; JSON now supported
-- Rate limiter responds with a Retry*After header once limits have been hit
-- `[/info/species]` to report common names of species and taxon ids
-- `[/lookup/:species/:symbol]` Look up the location of an object based on a symbol
-- `[/taxonomy/name]` Allow for searching of Taxonomy nodes by any linked name
+* Build a better rate limiter
+* Enable compression on REST site
+* Ensure rate limiter reports the time scale over which rate limiting occurs
+* Faster GeneTree serlialisation; JSON now supported
+* Rate limiter responds with a `Retry-After` header once limits have been hit
+* `[/info/species]` to report common names of species and taxon ids
+* `[/lookup/:species/:symbol]` Look up the location of an object based on a symbol
+* `[/taxonomy/name]` Allow for searching of Taxonomy nodes by any linked name
 
 ## Bugfixes:
 
-- Detect content in REST does not understand Accepts
-- GFF3 for cds features invalid, duplicate ids for simple features
-- Serialisations choose to send the content*type back as text/plain
-- `[/homology]` throws an exception when you ask for orthologues of the species the gene is from
-- `[/xrefs/symbol/:species/:symbol]` does not respond to object type filtering
-- `[/xrefs]` fails to report linkage types for GO xrefs
+* Detect content in REST does not understand Accepts
+* GFF3 for cds features invalid, duplicate ids for simple features
+* Serialisations choose to send the `content-type` back as `text/plain`
+* `[/homology]` throws an exception when you ask for orthologues of the species the gene is from
+* `[/xrefs/symbol/:species/:symbol]` does not respond to object type filtering
+* `[/xrefs]` fails to report linkage types for GO xrefs
 
 ---
 
@@ -95,8 +95,8 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Bugfixes
 
-- `[/xrefs]` fails to report linkage types for ontology xrefs
-- `[/homology/id]` and `[/homology/symbol]` failed when querying for the  same species as the member
+* `[/xrefs]` fails to report linkage types for ontology xrefs
+* `[/homology/id]` and `[/homology/symbol]` failed when querying for the  same species as the member
 
 ---
 
@@ -104,8 +104,8 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Bugfixes:
 
-- `[/lookup/id]` and `[/xrefs/symbol]` were using the parameter object rather than object_type
-- `[/homology]` endpoints would accept only one instance of target_taxon and target_species. We now allow multiples as intended
+* `[/lookup/id]` and `[/xrefs/symbol]` were using the parameter object rather than object_type
+* `[/homology]` endpoints would accept only one instance of target_taxon and target_species. We now allow multiples as intended
 
 ---
 
@@ -113,7 +113,7 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Bugfixes:
 
-- `[/feature/id]` Querying for features using a negative stranded feature reversed the strand of the retrieved object
+* `[/feature/id]` Querying for features using a negative stranded feature reversed the strand of the retrieved object
 
 ---
 
@@ -121,7 +121,7 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Bugfixes:
 
-- Lookup with a non-indexed stable identifiers in databases other than core failed
+* Lookup with a non-indexed stable identifiers in databases other than core failed
 
 ---
 
@@ -129,29 +129,29 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- Improved error page when a user goes to an unknown documentation page
-- Rate limiter responds with a Retry*After header once limits have been hit
-- `[/assembly/info]` should return those Slices which are part of the karyotype
-- `[/feature/translation/:id]` Support the retrieval of splice sites with respect from a translation
-- `[/feature/translation]` Improved translation feature support for GFF3
-- `[/info/analysis]` Support retrieval of analysis logic names
-- `[/info/analysis]` to provide logic names available
-- `[/info/biotype]` Support for listing available biotypes
-- `[/info/data]` has been sped up for Ensembl Genomes servers (Ensembl Bacteria)
-- `[/info/external_db]` Support retrieval of external dbs
-- `[/info/external_dbs]` Support the retrieval of external dbs
-- `[/lookup/id]` Provide more information for a lookup ID
-- `[/info/biotypes]` Support retrieval of biotypes from the rest api
+* Improved error page when a user goes to an unknown documentation page
+* Rate limiter responds with a `Retry-After` header once limits have been hit
+* `[/assembly/info]` should return those Slices which are part of the karyotype
+* `[/feature/translation/:id]` Support the retrieval of splice sites with respect from a translation
+* `[/feature/translation]` Improved translation feature support for GFF3
+* `[/info/analysis]` Support retrieval of analysis logic names
+* `[/info/analysis]` to provide logic names available
+* `[/info/biotype]` Support for listing available biotypes
+* `[/info/data]` has been sped up for Ensembl Genomes servers (Ensembl Bacteria)
+* `[/info/external_db]` Support retrieval of external dbs
+* `[/info/external_dbs]` Support the retrieval of external dbs
+* `[/lookup/id]` Provide more information for a lookup ID
+* `[/info/biotypes]` Support retrieval of biotypes from the rest api
 
 ## Bugfixes:
 
-- REST GFF CDS Line is incorrect. ID can repeat in a single GFF file
-- `[/compara/homology]` throws an exception when requesting ENSEMBL_PROJECTION ortholog alignmnets
-- `[/feature/id]` does not work for regulatory regions
-- `[/feature/id]` is failing as it thinks species is a HASH ref
-- `[/genetree/symbol]` and `[/feature/translation]` modified to default object type
-- `[/ontology/descendents/:id]` Using the zero_distance parameter destroys any output
-- `[/ontology/id/:id]` Giving a bogus ontology ID causes a stack trace
+* REST GFF CDS Line is incorrect. ID can repeat in a single GFF file
+* `[/compara/homology]` throws an exception when requesting ENSEMBL_PROJECTION ortholog alignmnets
+* `[/feature/id]` does not work for regulatory regions
+* `[/feature/id]` is failing as it thinks species is a HASH ref
+* `[/genetree/symbol]` and `[/feature/translation]` modified to default object type
+* `[/ontology/descendents/:id]` Using the zero_distance parameter destroys any output
+* `[/ontology/id/:id]` Giving a bogus ontology ID causes a stack trace
 
 ---
 
@@ -159,11 +159,11 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- `[/info/species]` allows you to specify a division to limit the data by
+* `[/info/species]` allows you to specify a division to limit the data by
 
 ## Bugfixes:
 
-- `[/homology/id]` and `[/homology/symbol]` have improved error reporting when IDs and symbols cannot be found
+* `[/homology/id]` and `[/homology/symbol]` have improved error reporting when IDs and symbols cannot be found
 
 ---
 
@@ -171,7 +171,7 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ##Bugfixes:
 
-- `[/vep]` could not find a region due to changes in the backing Lookup object
+* `[/vep]` could not find a region due to changes in the backing Lookup object
 
 ---
 
@@ -179,26 +179,26 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- `[/feature/id]` allows for the querying of features overlapping a stable ID
-- `[/genetree/member/id]` allows for the querying of a GeneTree by one of its member's stable ID
-- `[/genetree/member/symbol]` allows for the querying of a GeneTree by one of its member's symbols (its name e.g. BRAF)
-- `[/taxonomy/]` provides methods for querying the Ensembl taxonomy database. This is a mirror of NCBI's taxonomy.
-- `[/ontology/]` provides methods for querying the Ensembl ontology database
-- `[/lookup/id]` replaces `[/lookup]` but the old endpoint remains active. This endpoint now supports genomic location reporting of features when output format is set to full. Please use the new endpoint.
-- `Model::Registry` supports use of Ensembl Genomes' `Bio::EnsEMBL::LookUp` object to help loading bacteria datasets
-- All location based services no longer support underscores as a numeric separator. All now support UCSC names for sequence regions
-- Support for CrossOrigin resource sharing via `Plack::Middleware::CrossOrigin`
+* `[/feature/id]` allows for the querying of features overlapping a stable ID
+* `[/genetree/member/id]` allows for the querying of a GeneTree by one of its member's stable ID
+* `[/genetree/member/symbol]` allows for the querying of a GeneTree by one of its member's symbols (its name e.g. BRAF)
+* `[/taxonomy/]` provides methods for querying the Ensembl taxonomy database. This is a mirror of NCBI's taxonomy.
+* `[/ontology/]` provides methods for querying the Ensembl ontology database
+* `[/lookup/id]` replaces `[/lookup]` but the old endpoint remains active. This endpoint now supports genomic location reporting of features when output format is set to full. Please use the new endpoint.
+* `Model::Registry` supports use of Ensembl Genomes' `Bio::EnsEMBL::LookUp` object to help loading bacteria datasets
+* All location based services no longer support underscores as a numeric separator. All now support UCSC names for sequence regions
+* Support for CrossOrigin resource sharing via `Plack::Middleware::CrossOrigin`
 
 ## Configuration:
 
-- `[/species/info]` now supports the vast numbers Ensembl Bacteria brings into the registry
-- All models if they need access to the Catalyst context object implement methods to access this without explicit pass throughs. Affects all Models apart from Registry
+* `[/species/info]` now supports the vast numbers Ensembl Bacteria brings into the registry
+* All models if they need access to the Catalyst context object implement methods to access this without explicit pass throughs. Affects all Models apart from Registry
 
 ## Bugfixes:
 
-- Model::Registry has `Bio::EnsEMBL::LookUp` configuration attributes
-- `Controller::Taxonomy` allows for database name configuration
-- `Controller::Ontology` allows for database name configuration
+* Model::Registry has `Bio::EnsEMBL::LookUp` configuration attributes
+* `Controller::Taxonomy` allows for database name configuration
+* `Controller::Ontology` allows for database name configuration
 
 ---
 
@@ -206,19 +206,19 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- Support for Sereal encoding format from Sereal::Encoder. MIME type `application/x-sereal` is required and extension support is `.sereal`
-- Support for MessagePack encoding format from Data::MessagePack. MIME type `application/x-msgpack` is required and extension support is `.msgpack`
+* Support for Sereal encoding format from Sereal::Encoder. MIME type `application/x-sereal` is required and extension support is `.sereal`
+* Support for MessagePack encoding format from Data::MessagePack. MIME type `application/x-msgpack` is required and extension support is `.msgpack`
 
 ## Configuration:
 
-- Configuration has switched to a more Catalyst friendly method. Config is namespaced to the object which uses it and is accessible via local accessors in that object.
-  - Registry and Documentation are prefixed with `Model::` 
-  - Feature and Sequence are prefixed with `Controller::`
-  - All other configuration sections are unaffected
+* Configuration has switched to a more Catalyst friendly method. Config is namespaced to the object which uses it and is accessible via local accessors in that object.
+  * Registry and Documentation are prefixed with `Model::` 
+  * Feature and Sequence are prefixed with `Controller::`
+  * All other configuration sections are unaffected
 
 ## Bugfixes:
 
-- `[/feature]` CDS no longer report a protein as an exon's ID since ID should be unique in a file. Instead this is available via the protein_id attribute
+* `[/feature]` CDS no longer report a protein as an exon's ID since ID should be unique in a file. Instead this is available via the protein_id attribute
 
 ---
 
@@ -226,11 +226,11 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Output:
 
-- `[/homology]` now supports the retrieval of CDNA sequences
+* `[/homology]` now supports the retrieval of CDNA sequences
 
 ## Bugfixes:
 
-- `[/feature]` had incorrect documentation WRT features available
+* `[/feature]` had incorrect documentation WRT features available
 
 ---
 
@@ -238,9 +238,9 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## Bugfixes:
 
-- `[/sequence/region]` had not been recoded for our multiple sequence changes resulting in a broken service
-- Documentation needs to internally escape characters like + for example as Catalyst does not like this
-- `[/vep]` was attempting to multiple `intron_number` and `exon_number` to avoid stringification of numerics; these two fields are not numeric
+* `[/sequence/region]` had not been recoded for our multiple sequence changes resulting in a broken service
+* Documentation needs to internally escape characters like + for example as Catalyst does not like this
+* `[/vep]` was attempting to multiple `intron_number` and `exon_number` to avoid stringification of numerics; these two fields are not numeric
 
 ---
 
@@ -248,42 +248,42 @@ A transition from beta to a more stable interface for users, better documentatio
 
 ## New Features:
 
-- `[/feature]` new endpoint for retrieval of features by a genomic location
-- `[/sequence]` now responds to Content-type `text/plain` with an unformatted raw String of sequence
-- `Plack::Middleware::Throttle` is an optional install; custom extensions available with this checkout. Brings rate limiting to the REST API service
-- Using CHI to cache documentation API responses
-- Content type detection carried out using file name extensions as well as the existing mechanisms. Supported on all endpoints
-- `[/sequence]` supports multiple sequences from a single identifier e.g. proteins from a gene identifier
-- Online change log
-- `[/genetree]` now supports CDNA sequence in PhyloXML output
+* `[/feature]` new endpoint for retrieval of features by a genomic location
+* `[/sequence]` now responds to Content-type `text/plain` with an unformatted raw String of sequence
+* `Plack::Middleware::Throttle` is an optional install; custom extensions available with this checkout. Brings rate limiting to the REST API service
+* Using CHI to cache documentation API responses
+* Content type detection carried out using file name extensions as well as the existing mechanisms. Supported on all endpoints
+* `[/sequence]` supports multiple sequences from a single identifier e.g. proteins from a gene identifier
+* Online change log
+* `[/genetree]` now supports CDNA sequence in PhyloXML output
 
 ## Output:
 
-- `[/vep]` alleles now an array with allele_string explicit instead of as key.
-- `[/info/species]` reports the division of a species; Ensembl Genomes extension
-- Mime types changed for many services to denote non-standard types. We now use `text/x-fasta`, `text-x-gff3`, `text/x-seqxml+xml` and `text/x-phyloxml+xml`.
-- `[/genetree]` has had NHX format retired in favor of PhyloXML
-- `[/map]` Translate coordinates for transcript/translation to genomic now reports the sequence region name
+* `[/vep]` alleles now an array with allele_string explicit instead of as key.
+* `[/info/species]` reports the division of a species; Ensembl Genomes extension
+* Mime types changed for many services to denote non-standard types. We now use `text/x-fasta`, `text-x-gff3`, `text/x-seqxml+xml` and `text/x-phyloxml+xml`.
+* `[/genetree]` has had NHX format retired in favor of PhyloXML
+* `[/map]` Translate coordinates for transcript/translation to genomic now reports the sequence region name
 
 ## Bugfixes:
 
-- 2 Y regions returned from `[/assembly/info/human]` fixed
-- JSON serialiser mis-encodes numerics as Strings due to MySQL DBD issues
-- Location parser method does not handle `GL1923.1` properly
-- `[/genetree]` parameter nh_format has no effect on the newick output
+* 2 Y regions returned from `[/assembly/info/human]` fixed
+* JSON serialiser mis-encodes numerics as Strings due to MySQL DBD issues
+* Location parser method does not handle `GL1923.1` properly
+* `[/genetree]` parameter nh_format has no effect on the newick output
 
 ## Configuration:
 
-- Removal of `<Compara>` configuration option; new code introduced to select the best compara available based upon species.division  
-- Documentation supports variable replacement for easier configuration by third parties
-- CHI cache support in configuration; see CHI's POD and our production configuration about how you can configure it  
-- URL, name and logo now configurable
+* Removal of `<Compara>` configuration option; new code introduced to select the best compara available based upon species.division  
+* Documentation supports variable replacement for easier configuration by third parties
+* CHI cache support in configuration; see CHI's POD and our production configuration about how you can configure it  
+* URL, name and logo now configurable
 
 ---
 
 # 1.0.0 - 2012/09/05
 
-- Initial revision of REST API
-- Support for comparative genomics, cross references, ID lookup, mapping coordinates, sequences & variations
-- Information endpoints also made available
-- Documentation added for all end points
+* Initial revision of REST API
+* Support for comparative genomics, cross references, ID lookup, mapping coordinates, sequences & variations
+* Information endpoints also made available
+* Documentation added for all end points