On Jul 7, 2015 3:34 PM, "Sandra McCann" <scmccann2000@xxxxxxxxx>
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@xxxxxxxxxxxx>
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@xxxxxxxxxxxx>
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@xxxxxxxxxxxxxxxxxxxxxxx
>>>> 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. 