(sent to both docs and websites, though not cross posted)
Now that F8 shipped and F9 is on the horizon, its time to look at moving some more of that content out of the wiki and either into docs.fedoraproject.org and fedoraproject.org. This won't be a fun task.
Pros: 1) We'll have more control and process around the content that goes to these sites. This allows us to make it more 'official'. 2) It will be more easily translatable. 3) Less reliance on Moin
Cons: 1) It raises the barrier to create these pages 2) It adds more process 3) Its difficult to determine what content belongs where.
I've created an initial http://fedoraproject.org/wiki/Websites/Removables page for stuff thats in the wiki that is a good candidate for the static content. The trick here is that, and lets be honest, much of what is on the wiki right now is garbage. This is especially true with regards to our end users. I think focus on fp.o should be on consolidation. Users have short attention spans, so less is more. If we find the need to have a higher-detail document, it should probably be in the docs realm and use its processes.
What do you guys think?
-Mike
On Saturday 01 December 2007 02:35:02 Mike McGrath wrote:
(sent to both docs and websites, though not cross posted)
Now that F8 shipped and F9 is on the horizon, its time to look at moving some more of that content out of the wiki and either into docs.fedoraproject.org and fedoraproject.org. This won't be a fun task.
Pros:
- We'll have more control and process around the content that goes to
these sites. This allows us to make it more 'official'. 2) It will be more easily translatable. 3) Less reliance on Moin
Cons:
- It raises the barrier to create these pages
- It adds more process
- Its difficult to determine what content belongs where.
I've created an initial http://fedoraproject.org/wiki/Websites/Removables page for stuff thats in the wiki that is a good candidate for the static content. The trick here is that, and lets be honest, much of what is on the wiki right now is garbage. This is especially true with regards to our end users. I think focus on fp.o should be on consolidation. Users have short attention spans, so less is more. If we find the need to have a higher-detail document, it should probably be in the docs realm and use its processes.
What do you guys think?
-Mike
I think that the documentations, i.e.: Guidelines (Packaging, Translation, Installation (yes, installation guide, like the one here[1])), Release Notes, etc... Should be edited on the wiki, and when they reach their final form, they are transferred from the wiki to docs.fedoraproject.org.
This may sound crazy but, why don't you move the contributors' pages to some static pages? Say, on their fedorapeople spaces, that way, they can customize them ;) and it'll be easier for whoever wants to view them, since it'll be just username.fedorapeople.org, for those who can't design their own pages, fedora-websites can be asked to create a template for them, not to mention that they can create a tiny webpage there, where they can have links to whatever they have in their space...
Cheers!
[1] http://www.my-guides.net/en/content/view/91/26/
On Sat, 2007-12-01 at 14:28 +0400, Laith Juwaidah wrote:
I think that the documentations, i.e.: Guidelines (Packaging, Translation, Installation (yes, installation guide, like the one here[1])),
We already have an installation guide and it doesn't benefit from being worked on the wiki. The one you link to here couldn't be used, it's pretty scary.
Release Notes, etc... Should be edited on the wiki, and when they reach their final form, they are transferred from the wiki to docs.fedoraproject.org.
Some content benefits from the wiki for drafting. Anything the length of a guide or long tutorial suffers on the wiki.
This may sound crazy but, why don't you move the contributors' pages to some static pages? Say, on their fedorapeople spaces, that way, they can customize them ;) and it'll be easier for whoever wants to view them, since it'll be just username.fedorapeople.org, for those who can't design their own pages, fedora-websites can be asked to create a template for them, not to mention that they can create a tiny webpage there, where they can have links to whatever they have in their space...
True, we could do that. The wiki pages were used initially because that was all we had.
- Karsten
websites@lists.fedoraproject.org