Full disclosure: I'm the author of these. I was encouraged to link them
here several months ago on IRC when asking some clarifying questions for
writing one of them; and I just finally got around to sending this.
When running `make` to generate the HTML version of the site, all
Markdown files are automatically found and converted - including
README.md and CONTRIBUTING.md.
These two aren't really wanted, and the resulting HTML versions need to
be ignored or deleted. It's not sufficient to add them to .gitignore,
because they'll still be there in the filesystem causing confusion, even
if the risk of committing them to Git is minimized.
This change filters them out of the Makefile's argument list of Markdown
files that should be automatically converted to HTML, so the unwanted
versions don't get generated in the first place.
Before:
```
$ make
pandoc -f markdown-smart+autolink_bare_uris --template index.tmpl CONTRIBUTING.md -o CONTRIBUTING.html
pandoc -f markdown-smart+autolink_bare_uris --template index.tmpl README.md -o README.html
```
After:
```
$ make
make: Nothing to be done for 'all'.
```
The bullet points in the "API access" section are separated by newlines
in the source markdown. Unfortunately, this confuses the renderer in
such a way that in the published site the text appears *below* the
bullet point rather than next to it.
Removing the blank lines between bullet points fixes this.
The default version of Pandoc available on the stable ("Stretch")
release of Debian is too old, so running `make` fails. A newer version
is required. This change updates the docs to mention that.
