diff --git a/pypistats/templates/faqs.html b/pypistats/templates/faqs.html new file mode 100644 index 0000000..3784174 --- /dev/null +++ b/pypistats/templates/faqs.html @@ -0,0 +1,37 @@ +{% extends "layout.html" %} +{% block title %}PyPI Download Stats{% endblock %} +{% block body %} +
+ PyPI provides download records as a publicly available dataset on Google's BigQuery. You can access the data with a Google Cloud account here. +
++ The data update begins at 01:00:00 UTC and should take less than 10 minutes. +
++ PyPI download records are generated by a service known as linehaul. The previous iteration of the service had an issue which caused it to restart regularly due to running out of memory, resulting in a large quantity of dropped download records. On July 26, a newer version of the service was deployed, which is much more robust and reliable. +
+
+ The cumulative download counts consider only the download records which are not from a known set of PyPI mirror applications, namely bandersnatch, z3c.pypimirror, Artifactory, and devpi. In other words, the cumulative download counts take the sum of the downloads from the Without_mirrors dataset from the chart.
+
+ The intent of disregarding mirrors is to provide metrics that reflect end-user download aggregation. +
+ +{% endblock %} diff --git a/pypistats/templates/layout.html b/pypistats/templates/layout.html index 8af7310..7e1488f 100644 --- a/pypistats/templates/layout.html +++ b/pypistats/templates/layout.html @@ -65,6 +65,8 @@