Pulp

The documentation for plugin writers needs to explain that a new repository version should be created any time the content of a repository changes.

There are two places to consider.

A high level explanation of the options (currently, just using RepositoryVersion as a context manager) should be included in the sync documentation in the plugin-writer docs.
https://github.com/asmacdo/plugin_template/blob/add-plugin-writer-docs/docs/plugin-writer/tasks/add-remove.rst

A specific example is included in the sync task in the plugin_template. Please check that the comments are sufficient, and that they match the explanation in the plugin writer docs.
https://github.com/asmacdo/plugin_template/blob/add-plugin-writer-docs/pulp_plugin_template/app/tasks/synchronizing.py#L39

Given that more work is being done with the DeclarativeVersion, keep in mind that what is added by this task will be expanded/revised soon.

Do not include custom views in this task.