<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Aug 25, 2016 at 10:54 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On 08/26/2016 04:07 AM, Lana Brindley wrote:<br>
> On 24/08/16 06:14, Andreas Jaeger wrote:<br>
>> Hi Docs team,<br>
>><br>
>> some time ago, we discussed with the infra team to move docs publishing<br>
>> for <a href="http://developer.openstack.org" rel="noreferrer" target="_blank">developer.openstack.org</a> and <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> from RackSpace<br>
>> CloudSites to pages under OpenStack Infra control.<br>
>><br>
>> At that time the following spec was written but never implemented:<br>
>> <a href="http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html" rel="noreferrer" target="_blank">http://specs.openstack.org/<wbr>openstack-infra/infra-specs/<wbr>specs/doc-publishing.html</a><br>
>><br>
>> Now, the infra team is planning to take this on  - and Jim Blair updated<br>
>> the specs to use AFS (Andrew File System) for it:<br>
>><br>
>> <a href="https://review.openstack.org/276482" rel="noreferrer" target="_blank">https://review.openstack.org/<wbr>276482</a><br>
><br>
> Yay!<br>
><br>
>><br>
>> A side benefit of the proposed spec is that stale files can get removed.<br>
><br>
> More yay!<br>
><br>
>><br>
>> Since <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> is mainly controlled by us, I'd like us all to<br>
>> review the spec and comment.<br>
><br>
> I have now done this thing.<br>
><br>
>><br>
>> Also, there's the question of migration and policy on retaining old<br>
>> documentation. Right now for our own documents, we remove (disable/add<br>
>> redirects) - but for projects, we keep them around forever. As an<br>
>> example, take a look at this document from December 2012:<br>
>> <a href="http://docs.openstack.org/developer/cinder/2012.2.1/" rel="noreferrer" target="_blank">http://docs.openstack.org/<wbr>developer/cinder/2012.2.1/</a><br>
>><br>
>> Note that it's very difficult to regenerate such old content - and<br>
>> nobody knows about it since there are no direct links to it.<br>
>><br>
>> So, moving forward, what policy do you suggest to have on content:<br>
>><br>
>> * Support all old releases - or only the active branches (with some<br>
>> grace period), so right now Liberty, Mitaka, Master (and perhaps Kilo<br>
>> for grace period)?<br>
><br>
> I like the idea of just migrating and supporting current releases. Will we have some way of archiving old content in a static way somehow, though?<br>
<br>
</div></div>What do we want?<br>
<br>
We have already removed old content for our *own* documents in the past<br>
- but not for other projects.<br>
<br></blockquote><div><br></div><div>In other documentation scenarios, a legal team would tell us when we can remove documents due to contracts in place or other terms of service types of needs. </div><div><br></div><div>In our case, the closest equivalent is our end-of-life policy, about 2 years after a release. I'd be comfortable with an archive policy that keeps all documents (project repos, openstack-manuals, api-site) for two years and then backs them up to a storage area that is not accessible from the web. </div><div><br></div><div>Lana, I believe you should review that with legal and the Foundation. There's the legal-discuss mailing list to get that started.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I don't think it makes sense to even archive documents from 2012.<br></blockquote><div><br></div><div>I disagree. I'd like some legal consultation here.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<span class=""><br>
>> * Migrate *all* content? Or only the content as specified above? Or<br>
>> start with a clean slate and let the site get filled for a few weeks<br>
>> from generated content?<br>
>> * Continue to support only official OpenStack projects (as listed in<br>
>> governance repo)?<br>
>> * ...<br>
>><br>
>> What are the best policies here? What did I miss?<br>
<br>
</span>So, who wants to propose some policy?<br></blockquote><div><br></div><div>I believe it depends on the archive policy establishment, since it's possible we use Cloud Sites for archive only. I believe the system should continue to support only official projects.</div><div> </div><div>Thanks for doing all this!<br></div><div>Anne</div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<span class="im HOEnZb"><br>
>> Btw. Jim is looking for volunteers to help with the spec, if you're<br>
>> interested in a task, please comment on the review and sign up,<br>
><br>
> Thanks for the update, Andreas. I've added a small note into this week's newsletter on this topic too.<br>
<br>
</span><div class="HOEnZb"><div class="h5">Andreas<br>
<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
<br>
______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>