Clear code comments with examples that help.
Recent revisions are kept. Restoring one creates a new revision.