Write API code with current docs, not guesses.
Recent revisions are kept. Restoring one creates a new revision.