update docs to include section on configuration

Rename keyring.rst to configuring.rst, and add a section discussing valid configuration files.

Add _keyring: section reference, and update instances of :doc:`keyring` to :ref:`keyring`.