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(a)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(a)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(a)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(a)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