Fix/update docstrings of build_swh_revision.
They were wrong/misleading:
- 'rev' is an int, not a dict
- 'commit' is the data, not metadata in the SWH sense
Migrated from D5255 (view on Phabricator)
They were wrong/misleading:
Migrated from D5255 (view on Phabricator)