Getting Started Docker/Container Guide

[Zach Oglesby]

On Tue, Jul 7, 2015, at 10:33 PM, Glen Rundblom wrote:
>
>
> On 07/07/2015 04:02 PM, Pete Travis
      wrote:
>>
>>
        On Jul 7, 2015 3:34 PM, "Sandra McCann"
        <scmccann2000 at gmail.com> wrote:
>>
>
>>
> Hi Glen
>>
>
>>
> 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.
>>
>
>>
> Might be worth bringing up on the next meeting if you can
        be there to discuss pros n cons etc.
>>
>
>>
> (fwiw I like the outline :-)
>>
>
>>
> Sandra
>>
>
>>
> On Mon, Jul 6, 2015 at 11:19 PM, Glen Rundblom <glen at rundblom.com>
        wrote:
>>
>>
>>
>>
>>
>>
>>
>> On 07/06/2015 08:44 AM, Sandra McCann wrote:
>>
>>>
>>
>>> My nickel - I took the 30 second tour of the docker
        user guide here:
>>
>>> https://docs.docker.com/userguide/
>>
>>>
>>
>>> And there's a lot to it.  What I'd be interested in
        as a potential docker user is probably two things:
>>
>>> 1 - what is it? (probably covered well in the
        docker guides)
>>
>>> 2- where do I  find images? (like can I run fedora
        as a container? )
>>
>>> 3 - assuming I found an image - how to I bring it
        up in Fedora?
>>
>>>
>>
>>> 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??
>>
>>>
>>
>>> Sandra
>>
>>>
>>
>>> On Fri, Jul 3, 2015 at 1:43 PM, Glen Rundblom <glen at rundblom.com>
        wrote:
>>
>>>>
>>
>>>> Hello,
>>
>>>> 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.
>>
>>>>
>>
>>>> Thoughts?
>>
>>>>
>>
>>>> Thank you,
>>
>>>> -Glen
>>
>>>>
>>
>>>> --
>>
>>>> docs mailing list
>>
>>>> docs at lists.fedoraproject.org
>>
>>>> To unsubscribe:
>>
>>>> https://admin.fedoraproject.org/mailman/listinfo/docs
>>
>>>
>>
>>>
>>
>>>
>>
>>>
>>
>> Hi Sandra!
>>
>> Thanks for taking the time to reply, I wasn’t thinking
        of it in that manner.
>>
>> Your points sparked an idea on the outline for the
        Container guide,
>>
>> So I put thoughts to keyboard please edit/comment:
>>
>>
>>
>> https://fedoraproject.org/wiki/Container-Docker_Getting_Started_Guide
>>
>>
>>
>> Thanks for the comment, it really helped my brain
        re-engage and inspired me.
>>
>>
>>
>>
>>
>>
>>
>> --
>>
>>


>> 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.


>> 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...


>> 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.


>> --Pete


>>
>>
> Thanks Pete for your reply.
>
    I think I would like to take on the task of making a guide.
    Brian Exelbierd offered to give me a hand and I would like to
    take that offer.
>
>
    I think I can contribute some use cases of my own as I am trying to
    see if Docker can solve some problems on my own Linux environment.
>
>
    I am finishing up a large project, and will be more regular at the
    docs meetings starting next week. However I would like to begin to
    get the ball rolling on this guide.
>
>
    Thanks!
>
    -Glen

I said this in the last meeting, but I will say it one more time. I
think a stand-alone guide for docker is a mistake. We have a hard enough
time keeping the guides we have up to date and if we start to add guides
for individual components it will become even more unwieldy.

It is my personal opinion that if you want to write about docker it
should be a section in a larger guide. Since I am sure that the world
would see it as blaspheme to include it in the virtualization guide, I
think it should be a section in the still to be written Server guide as
that flavor of Fedora has very focused support for docker.

Zach
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150708/30ab163f/attachment-0001.html>