<div dir="ltr">Thank you everyone for your feedback. I agree that snapshot carries some connotations that are not congruent with the mental model we want to present to our users. -1 from me also :)<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Mar 28, 2018 at 9:35 AM, David Davis <span dir="ltr"><<a href="mailto:daviddavis@redhat.com" target="_blank">daviddavis@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">I concur with @dalley. I read through the wikipedia article on snapshots in computer storage again and it just doesn’t seem to fit our model. Snapshots typically mean backups or archives and using them to describe the current state of the repository doesn’t make sense. As Ina says, a user should instead trigger a snapshot to create a copy/backup/archive of a repository’s content. Creating a new snapshot automatically by modifying the current state of the repo doesn’t make sense.</div><div class="gmail_extra"><span class="HOEnZb"><font color="#888888"><br clear="all"><div><div class="m_6802571011167203464gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><br></div><div>David<br></div></div></div></div></div></div></div></div></font></span><div><div class="h5">
<br><div class="gmail_quote">On Wed, Mar 28, 2018 at 9:24 AM, Daniel Alley <span dir="ltr"><<a href="mailto:dalley@redhat.com" target="_blank">dalley@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>-0 to changing the name.  Shorter is good, but I do think the name is misleading, and I disagree with the reasoning provided in the meeting the other day that "snapshot is more self-explanatory" - which I don't believe that it is.  <br><span><br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">this term is not unique to Pulp so it is easier to explain to the user</blockquote><br></span>I think Ina's point from the other day about what meaning other developers - not affiliated with pulp - associate with the name "snapshot" shouldn't be dismissed.  If we're reusing a term but attaching a meaning to it that is not quite the same as what the average person would guess it was, the information won't "stick" as well.<br><br>Sure, there are Pulp concepts that have to be explained to the user in any event, but we should still try to match their expectations as closely as possible.<br><br></div>And while I'd welcome data to the contrary, I don't think a user would have a harder time understanding the concept of a "RepositoryVersion" than they would a "Snapshot".  It's pure composition.  People are familiar with repositories, people are familiar with versions.. I don't see a problem there.<br><div class="gmail_extra"><br><div class="gmail_quote"><span>On Wed, Mar 21, 2018 at 8:00 AM, Ina Panova <span dir="ltr"><<a href="mailto:ipanova@redhat.com" target="_blank">ipanova@redhat.com</a>></span> wrote:<br></span><div><div class="m_6802571011167203464h5"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div><div>+1 to keep RepositoryVersion.<br><br></div>I also do not like the fact that it is quite long, that's why i do like the Snapshot, but thinking more of what snapshot is - is something that *you* need to trigger and it is not triggered automatically.<br></div>I'd say, we are working with repository versioning and not snapshots.<br><br></div>Back to aptly, they use the term shapshot, which you need to manually create <a href="https://www.aptly.info/doc/aptly/snapshot/create/" target="_blank">https://www.aptly.info/doc/apt<wbr>ly/snapshot/create/</a><br></div><div class="gmail_extra"><br clear="all"><div><div class="m_6802571011167203464m_2539514230356628398m_-6936561676775742045m_8859298596583950962gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><br><br>--------<br>Regards,<br><br>Ina Panova<br>Software Engineer| Pulp| Red Hat Inc.<br><br>"Do not go where the path may lead,<br> go instead where there is no path and leave a trail."<br></div></div></div><div><div class="m_6802571011167203464m_2539514230356628398m_-6936561676775742045h5">
<br><div class="gmail_quote">On Tue, Mar 20, 2018 at 5:14 PM, Matthias Dellweg <span dir="ltr"><<a href="mailto:dellweg@atix.de" target="_blank">dellweg@atix.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I guess, you meant 'RepositoryVersions' there. Maybe it is just a typo,<br>
or maybe your subconciousness already adepted to this change. ;)<br>
<br>
I'm +1, because from the REST API or model view, you do not ask what<br>
changed, but rather what is in that snapshot|version.<br>
And since you are renaming all models of pulp3 atm, you are giving a<br>
plugin maintainer a hard time, anyway. I think, it's now or never.<br>
<br>
Matthias<br>
<br>
On Tue, 20 Mar 2018 11:55:14 -0400<br>
<div><div class="m_6802571011167203464m_2539514230356628398m_-6936561676775742045m_8859298596583950962h5">David Davis <<a href="mailto:daviddavis@redhat.com" target="_blank">daviddavis@redhat.com</a>> wrote:<br>
<br>
> I’m not too worried about the change being too large. However, I<br>
> agree with @dalley though about snapshot not fitting my mental model<br>
> of how I view snapshots so any work seems like a loss to me.<br>
><br>
> I’m at -1 but am happy to talk more about it.<br>
><br>
><br>
> David<br>
><br>
> On Tue, Mar 20, 2018 at 11:08 AM, Daniel Alley <<a href="mailto:dalley@redhat.com" target="_blank">dalley@redhat.com</a>><br>
> wrote:<br>
><br>
> > I think of a "snapshot" like a VM snapshot or a Windows restore<br>
> > point - an archival copy of a very fluid and non-discrete system at<br>
> > one point in time.  By that understanding, the term<br>
> > RepositoryVersion probably fits better.<br>
> ><br>
> > I acknowledge the other benefits though.  -/+0?<br>
> ><br>
> > On Tue, Mar 20, 2018 at 10:51 AM, Dennis Kliban <<a href="mailto:dkliban@redhat.com" target="_blank">dkliban@redhat.com</a>><br>
> > wrote:<br>
> ><br>
> >> The article you link to just says that "a snapshot is the state of<br>
> >> a system at a particular point in time". The point in time can be<br>
> >> now or in the past.<br>
> >><br>
> >> The current state of a repository's content would be described as<br>
> >> the latest or most recent snapshot of a repository.<br>
> >><br>
> >> I am not too worried about the pain of doing the refactoring across<br>
> >> multiple repos.<br>
> >><br>
> >> On Tue, Mar 20, 2018 at 10:20 AM, David Davis<br>
> >> <<a href="mailto:daviddavis@redhat.com" target="_blank">daviddavis@redhat.com</a>> wrote:<br>
> >><br>
> >>> I have some reservations about using the name Snapshot.<br>
> >>> Specifically, I don’t think the snapshot term is a good fit. As<br>
> >>> wikipedia says [0], in CS a snapshot represents a state of<br>
> >>> something "in the past.” How would we describe the current state<br>
> >>> of the repository’s content then? I think "current version" would<br>
> >>> make sense but not "current snapshot.”<br>
> >>><br>
> >>> Also, changing the code in pulpcore and plugins is going to be a<br>
> >>> pain. Especially with the other things we have planned like<br>
> >>> renaming Importers to Remotes. I think this should factor into<br>
> >>> our decision as well.<br>
> >>><br>
> >>> [0] <a href="https://en.wikipedia.org/wiki/Snapshot" rel="noreferrer" target="_blank">https://en.wikipedia.org/wiki/<wbr>Snapshot</a><br>
> >>><br>
> >>><br>
> >>> David<br>
> >>><br>
> >>> On Tue, Mar 20, 2018 at 10:05 AM, Austin Macdonald<br>
> >>> <<a href="mailto:austin@redhat.com" target="_blank">austin@redhat.com</a>> wrote:<br>
> >>><br>
> >>>> "Snapshot" is a nice way to explain what a RepositoryVersion is,<br>
> >>>> especially in the context of Publications. "Publish a<br>
> >>>> snapshot."  I like the idea, and I informally floated it around<br>
> >>>> PulpCon but decided not to propose it because:<br>
> >>>><br>
</div></div>> >>>>    - Snapshot is a little misleading about the actual data we<br>
<span>> >>>> store. Specifically, since RepositoryVersions are stored as<br>
> >>>> diffs, when a user views the "content in a version", this is<br>
> >>>> calculated. This is a subtle point, and hopefully not user<br>
> >>>> facing at all, but I think snapshot implies a little bit more<br>
> >>>> certainty than we can offer.<br>
</span>> >>>>    - A snapshot also implies a slightly different workflow to<br>
<span>> >>>> me. The workflow I expect with snapshots is to change<br>
> >>>> Repositories "willy nilly", and when you are satisfied, you<br>
> >>>> "take" an snapshot. Versions imply the workflow we have, which<br>
> >>>> is that any time the content set of a Repository is changed, a<br>
> >>>> new version is created.<br>
> >>>><br>
> >>>> However, I think those concerns are minor and are overshadowed<br>
> >>>> by the potential benefits. Also, I see a direct connection to<br>
> >>>> the thread "Plugin relationship to tasks". The name<br>
> >>>> Snapshot/RepositoryVersion is part of the choice of how we<br>
> >>>> portray the changing of content set of a repo.<br>
> >>>><br>
</span>> >>>>    1. We can "change a repo" which creates a new version.<br>
> >>>>    2. We can "create a new version" which has different content.<br>
<div><div class="m_6802571011167203464m_2539514230356628398m_-6936561676775742045m_8859298596583950962h5">> >>>><br>
> >>>> To me (1) implies "dispatching a task that has the side effect of<br>
> >>>> creating a new repository version. It would lend itself well to<br>
> >>>> the concept of "managing repositories" rather than "managing<br>
> >>>> versions/snapshots". If we choose this way, I think the name<br>
> >>>> Snapshot conceptually makes sense.<br>
> >>>><br>
> >>>> (2) implies a POST to create a new RepositoryVersion. As<br>
> >>>> explained in the plugin tasks thread, there are some problems<br>
> >>>> with this, but it is similar to the concept of creating a git<br>
> >>>> commit. I think we wouldn't think of "creating a new Snapshot"<br>
> >>>> to change the content.<br>
> >>>><br>
> >>>> On Tue, Mar 20, 2018 at 9:33 AM, Dennis Kliban<br>
> >>>> <<a href="mailto:dkliban@redhat.com" target="_blank">dkliban@redhat.com</a>> wrote:<br>
> >>>><br>
> >>>>> I propose that we rename the RepositoryVersion model in Pulp 3<br>
> >>>>> to Snapshot. The REST API would also change to use<br>
> >>>>> /api/v3/repositories/<uuid>/sn<wbr>apshot/<br>
> >>>>><br>
> >>>>> The Snapshot name is a better description of what a repository<br>
> >>>>> version is and it is also much shorter in length.<br>
> >>>>><br>
> >>>>> Thoughts?<br>
> >>>>><br>
> >>>>><br>
> >>>>> -Dennis<br>
> >>>>><br>
> >>>>> ______________________________<wbr>_________________<br>
> >>>>> Pulp-dev mailing list<br>
> >>>>> <a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
> >>>>> <a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
> >>>>><br>
> >>>>><br>
> >>>><br>
> >>>> ______________________________<wbr>_________________<br>
> >>>> Pulp-dev mailing list<br>
> >>>> <a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
> >>>> <a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
> >>>><br>
> >>>><br>
> >>><br>
> >><br>
> >> ______________________________<wbr>_________________<br>
> >> Pulp-dev mailing list<br>
> >> <a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
> >> <a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
> >><br>
> >><br>
> ><br>
<br>
<br>
<br>
<br>
</div></div>Herzliche Grüße aus München<br>
<br>
Matthias Dellweg<br>
______________________________<wbr>________________________<br>
Dr. Matthias M. Dellweg<br>
<br>
(Open Source Software Engineer)<br>
<br>
Tel: <a href="tel:%2B49%20%280%2989%20452%2035%2038-12" value="+4989452353812" target="_blank">+49 (0)89 452 35 38-12</a><br>
Fax: <a href="tel:%2B49%20%280%2989%20452%2035%2038-290" value="+49894523538290" target="_blank">+49 (0)89 452 35 38-290</a><br>
E-Mail: <a href="mailto:dellweg@atix.de" target="_blank">dellweg@atix.de</a><br>
<br>
ATIX - The Linux & Open Source Company<br>
<br>
ATIX Informationstechnologie und Consulting AG<br>
Parkring 15<br>
85748 Garching bei München<br>
<a href="http://www.atix.de" rel="noreferrer" target="_blank">www.atix.de</a><br>
<br>
<br>
Registergericht: Amtsgericht München, Registernummer: HRB 168930<br>
USt.-Id.: DE209485962<br>
Vorstand: Thomas Merz (Vors.), Mark Hlawatschek<br>
Vorsitzender des Aufsichtsrats: Dr. Martin Buss<br>
<br>______________________________<wbr>_________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
<br></blockquote></div><br></div></div></div>
<br>______________________________<wbr>_________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
<br></blockquote></div></div></div><br></div></div>
<br>______________________________<wbr>_________________<br>
Pulp-dev mailing list<br>
<a href="mailto:Pulp-dev@redhat.com" target="_blank">Pulp-dev@redhat.com</a><br>
<a href="https://www.redhat.com/mailman/listinfo/pulp-dev" rel="noreferrer" target="_blank">https://www.redhat.com/mailman<wbr>/listinfo/pulp-dev</a><br>
<br></blockquote></div><br></div></div></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>