finesse registration API

Finesse the public registration API and update documentation with a better
description of the algorithm.