IPv6 documentation

[Peter Vrabec]

Hi folks.

I wrote an IPv6 documentation and I'd like to place on fedora wiki.
But I'm little bit confused of current process, so I'm asking for help.
I really like to do it as easy as possible. My naive vision is
that somebody tell me were I can place link to my documentation
and I'll do it that way. Of course I appreciate any asistence with
this, since I'm not very experienced in wiki.

I have an account and I'm in edit group and I hope I have all other
stuff for that  :-)

thnx.

[Rahul Sundaram]

Peter Vrabec wrote:
>  Hi folks.
>  
>  I wrote an IPv6 documentation and I'd like to place on fedora wiki.
>  But I'm little bit confused of current process, so I'm asking for help.
>  I really like to do it as easy as possible. My naive vision is
>  that somebody tell me were I can place link to my documentation
>  and I'll do it that way. Of course I appreciate any asistence with
>  this, since I'm not very experienced in wiki.
>  
>  I have an account and I'm in edit group and I hope I have all other
>  stuff for that  :-) 
If you are planning to write a longer published guide, place it at 
http://fedoraproject.org/wiki/Docs/Drafts/. If you intend to keep it in 
the wiki might use the root namespace.

Rahul

[Karsten Wade]

On Wed, 2006-12-13 at 22:19 +0530, Rahul Sundaram wrote:

>  If you are planning to write a longer published guide, place it at 
>  http://fedoraproject.org/wiki/Docs/Drafts/. If you intend to keep it in 
>  the wiki might use the root namespace. 
Why not the Docs/ namespace?

Documents should either be under a project namespace (SELinux/,
Packaging/, etc.) or in the Docs/* namespace.

Putting things with random names at the root namespace only makes them
harder to find later.

We could do a lot with categories, yes, but we haven't.

- Karsten
-- 
Karsten Wade, RHCE, 108 Editor    ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
   quaid.108.redhat.com           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

[Peter Vrabec]

Here we go: 
http://fedoraproject.org/wiki/IPv6Guide

Do you have any idea where I can create link to this page?

On Wed, 13 Dec 2006 17:05:56 +0100
Peter Vrabec <pvrabec(a)redhat.com&gt; wrote:

>  Hi folks.
>  
>  I wrote an IPv6 documentation and I'd like to place on fedora wiki.
>  But I'm little bit confused of current process, so I'm asking for
>  help. I really like to do it as easy as possible. My naive vision is
>  that somebody tell me were I can place link to my documentation
>  and I'll do it that way. Of course I appreciate any asistence with
>  this, since I'm not very experienced in wiki.
>  
>  I have an account and I'm in edit group and I hope I have all other
>  stuff for that  :-)
>  
>  thnx.
>  
>  
>  
>  
>  
>  
>

[Karsten Wade]

On Thu, 2006-12-14 at 16:07 +0100, Peter Vrabec wrote:
>  Here we go: 
>  http://fedoraproject.org/wiki/IPv6Guide
>  
>  Do you have any idea where I can create link to this page? 
Well, you would have it link from Docs/, but we don't put anything there
that hasn't followed the workflow to ensure quality, etc.[1]

This is why I _don't_ recommend putting documents in the root namespace.

If you want this to be a stand-alone document, then we should move it
into Docs/Drafts/ and get people to read it there.  When it is ready,
copy it to Docs/ and make the Docs/Drafts/ space for working on the F*7
version.

Sometimes we can fast-track a document by putting it directly in Docs/
and rapidly cleaning it up.  But if there is not a hurry to publish a
permanent URL that is from under Docs/ namespace, we should use the
regular workflow.

If you want this to be part of an IPv6 project, then that project needs
to make a new namespace (such as fp.org/wiki/IPv6/) and then you can put
the guide under there.

[1] http://fedoraproject.org/wiki/DocsProject/WorkFlow

- Karsten
-- 
Karsten Wade, RHCE, 108 Editor    ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
   quaid.108.redhat.com           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

[Peter Vrabec]

On Thu, 14 Dec 2006 12:08:16 -0800
Karsten Wade <kwade(a)redhat.com&gt; wrote:

>  On Thu, 2006-12-14 at 16:07 +0100, Peter Vrabec wrote:
>  > Here we go: 
>  > http://fedoraproject.org/wiki/IPv6Guide
>  > 
>  > Do you have any idea where I can create link to this page?
>  
>  Well, you would have it link from Docs/, but we don't put anything
>  there that hasn't followed the workflow to ensure quality, etc.[1]
>  
>  This is why I _don't_ recommend putting documents in the root
>  namespace.
>  
>  If you want this to be a stand-alone document, then we should move it
>  into Docs/Drafts/ and get people to read it there.  When it is ready,
>  copy it to Docs/ and make the Docs/Drafts/ space for working on the 
>  F*7 version. 
So If I understand, we  can move it to
Docs/Drafts/ and find someone,
who can approved  it. After it's approved we move it to Docs/.
Is this way, alright?

>  
>  Sometimes we can fast-track a document by putting it directly in Docs/
>  and rapidly cleaning it up.  But if there is not a hurry to publish a
>  permanent URL that is from under Docs/ namespace, we should use the
>  regular workflow.
>  
>  If you want this to be part of an IPv6 project, then that project
>  needs to make a new namespace (such as fp.org/wiki/IPv6/) and then
>  you can put the guide under there.
>  
>  [1] http://fedoraproject.org/wiki/DocsProject/WorkFlow
>  
>  - Karsten

[Karsten Wade]

On Fri, 2006-12-15 at 12:08 +0100, Peter Vrabec wrote:
>  So If I understand, we  can move it to Docs/Drafts/ and find
> someone,
>  who can approved  it. After it's approved we move it to Docs/.
>  Is this way, alright? 
Essentially, yes.  Putting it into the drafting area means we can make
the kind of changes that e.g. Timothy Murphy just mentioned in his post.

The reasoning is pretty simple.  If we put up documents as "ready to
read" and they are not really ready, that makes people discouraged who
read it.  They are not likely to come back later to see if it is
improved.

But showing someone a document in a clearly marked "Drafts" space means
they know it is going to be unpolished, and they _will_ come back later
to see the improvements.

For editing, it would help if someone else with your knowledge of IPv6
(or more knowledge) can do a technical edit.  This group will help with
structure, language, etc.

- Karsten
-- 
Karsten Wade, RHCE, 108 Editor    ^     Fedora Documentation Project 
 Sr. Developer Relations Mgr.     |  fedoraproject.org/wiki/DocsProject
   quaid.108.redhat.com           |          gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

[Timothy Murphy]

Peter Vrabec wrote:

>  Here we go:
>  http://fedoraproject.org/wiki/IPv6Guide 
Sorry to be negative, but I think this document needs
quite a bit of polishing,
at least if it is aimed at people like me
ignorant of the details of ipv6.

I'd suggest an introduction explaining
more clearly what the aim of the exercise is.
And who, roughly, is it intended for?

Also some explanation of stateless vs stateful configuration.

-- 
Timothy Murphy  
e-mail (<80k only): tim /at/ birdsnest.maths.tcd.ie
tel: [phone]
s-mail: School of Mathematics, Trinity College, Dublin 2, Ireland