<div dir="ltr"><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial">"Snapshot" is a nice way to explain what a RepositoryVersion is, especially in the context of Publications. "Publish a snapshot."  I like the idea, and I informally floated it around PulpCon but decided not to propose it because:</div><div style="text-align:start;text-indent:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial"><ul style=""><li>Snapshot is a little misleading about the actual data we store. Specifically, since RepositoryVersions are stored as diffs, when a user views the "content in a version", this is calculated. This is a subtle point, and hopefully not user facing at all, but I think snapshot implies a little bit more certainty than we can offer.<br></li><li>A snapshot also implies a slightly different workflow to me. The workflow I expect with snapshots is to change Repositories "willy nilly", and when you are satisfied, you "take" an snapshot. Versions imply the workflow we have, which is that any time the content set of a Repository is changed, a new version is created.</li></ul></div><div>However, I think those concerns are minor and are overshadowed by the potential benefits. Also, I see a direct connection to the thread "Plugin relationship to tasks". The name Snapshot/RepositoryVersion is part of the choice of how we portray the changing of content set of a repo. </div><div><ol><li>We can "change a repo" which creates a new version. <br></li><li>We can "create a new version" which has different content.</li></ol><div>To me (1) implies "dispatching a task that has the side effect of creating a new repository version.<span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"> It would lend itself well to the concept of "managing repositories" rather than "managing versions/snapshots". If we choose this way, I think the name Snapshot conceptually makes sense.</span></div><div><span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"><br></span></div><div>(2) implies a POST to create a new RepositoryVersion. As explained in the plugin tasks thread, there are some problems with this, but it is similar to the concept of creating a git commit. I<span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"> think we wouldn't think of "creating a new Snapshot" to change the content.</span></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Mar 20, 2018 at 9:33 AM, Dennis Kliban <span dir="ltr"><<a href="mailto:dkliban@redhat.com" target="_blank">dkliban@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div><div>I propose that we rename the RepositoryVersion model in Pulp 3 to Snapshot. The REST API would also change to use /api/v3/repositories/<uuid>/<wbr>snapshot/<br><br></div>The Snapshot name is a better description of what a repository version is and it is also much shorter in length. <br><br></div>Thoughts?<span class="HOEnZb"><font color="#888888"><br><br><br></font></span></div><span class="HOEnZb"><font color="#888888">-Dennis<br></font></span></div>
<br>______________________________<wbr>_________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/<wbr>mailman/listinfo/pulp-dev</a><br>
<br></blockquote></div><br></div>