Ensure the plugin code is reusable and documented

[stringbean]

In addition to having lock file format documentation, it would be useful for other projects to have the core functionality reusable and documented.