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.
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
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
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@redhat.com 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.
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
On Thu, 14 Dec 2006 12:08:16 -0800 Karsten Wade kwade@redhat.com 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
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
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.
-
Karsten Wade -
Peter Vrabec -
Rahul Sundaram -
Timothy Murphy