<p dir="ltr"><br>
On Jul 7, 2015 3:34 PM, "Sandra McCann" <<a href="mailto:scmccann2000@gmail.com">scmccann2000@gmail.com</a>> wrote:<br>
><br>
> Hi Glen<br>
><br>
> At the doc meeting, the general consensus was that the upstream documentation was great as you say, and we would just put links to it in the Fedora Release Notes.<br>
><br>
> Might be worth bringing up on the next meeting if you can be there to discuss pros n cons etc.<br>
><br>
> (fwiw I like the outline :-)<br>
><br>
> Sandra<br>
><br>
> On Mon, Jul 6, 2015 at 11:19 PM, Glen Rundblom <<a href="mailto:glen@rundblom.com">glen@rundblom.com</a>> wrote:<br>
>><br>
>><br>
>><br>
>> On 07/06/2015 08:44 AM, Sandra McCann wrote:<br>
>>><br>
>>> My nickel - I took the 30 second tour of the docker user guide here:<br>
>>> <a href="https://docs.docker.com/userguide/">https://docs.docker.com/userguide/</a><br>
>>><br>
>>> And there's a lot to it. What I'd be interested in as a potential docker user is probably two things:<br>
>>> 1 - what is it? (probably covered well in the docker guides)<br>
>>> 2- where do I find images? (like can I run fedora as a container? )<br>
>>> 3 - assuming I found an image - how to I bring it up in Fedora?<br>
>>><br>
>>> It's the last two that I couldn't immediately find in my 30 second tour. Do they also exist in the docker doc set and I was just too lazy to find it??<br>
>>><br>
>>> Sandra<br>
>>><br>
>>> On Fri, Jul 3, 2015 at 1:43 PM, Glen Rundblom <<a href="mailto:glen@rundblom.com">glen@rundblom.com</a>> wrote:<br>
>>>><br>
>>>> Hello,<br>
>>>> So I was pretty excited to use docker, and thought it would be a good thing to make a getting started guide for docker and linux containers but, Docker's online documentation is excellent. I am not sure if it would be a good thing to make a guide that might be obsoleted quickly when such a good support resource exists.<br>
>>>><br>
>>>> Thoughts?<br>
>>>><br>
>>>> Thank you,<br>
>>>> -Glen<br>
>>>><br>
>>>> -- <br>
>>>> docs mailing list<br>
>>>> <a href="mailto:docs@lists.fedoraproject.org">docs@lists.fedoraproject.org</a><br>
>>>> To unsubscribe:<br>
>>>> <a href="https://admin.fedoraproject.org/mailman/listinfo/docs">https://admin.fedoraproject.org/mailman/listinfo/docs</a><br>
>>><br>
>>><br>
>>><br>
>>><br>
>> Hi Sandra!<br>
>> Thanks for taking the time to reply, I wasn’t thinking of it in that manner. <br>
>> Your points sparked an idea on the outline for the Container guide, <br>
>> So I put thoughts to keyboard please edit/comment:<br>
>><br>
>> <a href="https://fedoraproject.org/wiki/Container-Docker_Getting_Started_Guide">https://fedoraproject.org/wiki/Container-Docker_Getting_Started_Guide</a><br>
>><br>
>> Thanks for the comment, it really helped my brain re-engage and inspired me.<br>
>><br>
>><br>
>><br>
>> --<br>
>></p>
<p dir="ltr">There's a few things to consider here. There's value in demonstrating Fedora's potential - even if the upstream documentation is great. That could be done with the Release Notes, or a guide - the choice depends on how much effort you (you, Glen, not a figurative you) are willing to devote to initial writing and ongoing upkeep of the book, not just the viability of the content.</p>
<p dir="ltr">A container guide for Fedora IMO should have a different scope from upstream documentation. It could talk about use cases, management tools, deployment methodology, other things that I don't have the expertise to bring up. That sort of comprehensive coverage would merit an independent guide, but increases the amount of effort required...</p>
<p dir="ltr">If you want to go for it, there would be support from experienced devs and admins in the project and guidance on writing technique from the docs team. If you have a mild interest but don't want to commit to a huge book, we should talk about a different approach. Some day there will be tooling to publish arbitrary short articles, we could start prepping content for that time.</p>
<p dir="ltr">--Pete</p>