Overhaul BridgeDB's documentation and specification

BridgeDB's documentation is slightly outdated and its specification is severely outdated. It's time to update both.