A number of minor, but annoying, inconsistencies can be observed in what version 1 of our API currently returns. This task keeps track of the need of fixing all of them.
Here is a WIP list:
- the field "date" is sometimes a second-since-epoch floating point timestamp (example, example), and other a textual ISO 8601 timestamp (example). As a general rule, we should strive to always return the same type for the same dictionary key
- the "revision" endpoint uses two separate lists for listing the parent commits: "parents", and "parents_url" (example). This makes it annoying to use and does not structurally guarantee well-formendess (e.g., the two lists can have different length). We should use a single list of dicts
- the "release" and "revision" endpoints are inconsistent on how they indicate the author: revision (example) has "author" + "author_url", while "release" (example) has only "author" and no "author_url"