-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Hey *,
in spite of the recent "Docs Project Structure" mail, I've been trying to get my head around the wiki-space we own.
People who want to see how - should I call it unorganized? - our project's pages are, go to the DocsProject page and add anything to the url that doesn't exist, it'll give you a list of all pages beneath DocsProject/ (e.g. fp.o/wiki/DocsProject/foo)
So here's a reorganization proposal:
DocsProject/ |-- Join | |--Writer | |--Editor | --Translator |-- Goals / Mission |-- Schedule | --some pages with details (e.g. specific schedules on DUG, IG) |-- Tasks (considering all FDP related tasks and processes) | |--Guides | |--Relnotes | |--Browser splash page | |--Plone | |--Ideas-page | --Release announcement (not sure if we should do this) |-- FDSCo (or steering committee) | |--Charter | |--Meeting minutes | |--Elections | |--Nominations | --Task Schedule -- Workflow |--Docbook (how to write + intro) |--CVS (usage) |--Wiki (how to write) |--Publishing (web, PDF?) --Tools
And some general ideas: a) Create a default template for all Docs-related pages on the wiki (breadcrumb, default header, ...) to create a common look-and-feel b) Move everything in /Docs/Drafts to DocsProject/Drafts so users know that everything in /Docs is published documentation.
As I said, it's all just an idea / proposal. Comments?
Bart
- -- Bart couf@fedoraproject.org couf@skynet.be key fingerprint: 6AAB 544D 3432 D013 776D 3602 ADB6 6B2A D93F 0F93
On Fri, 2007-03-02 at 19:58 +0100, Bart Couvreur wrote:
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Hey *,
in spite of the recent "Docs Project Structure" mail, I've been trying to get my head around the wiki-space we own.
People who want to see how - should I call it unorganized? - our project's pages are, go to the DocsProject page and add anything to the url that doesn't exist, it'll give you a list of all pages beneath DocsProject/ (e.g. fp.o/wiki/DocsProject/foo)
So here's a reorganization proposal:
DocsProject/ |-- Join | |--Writer | |--Editor | --Translator |-- Goals / Mission |-- Schedule | --some pages with details (e.g. specific schedules on DUG, IG) |-- Tasks (considering all FDP related tasks and processes) | |--Guides | |--Relnotes | |--Browser splash page | |--Plone | |--Ideas-page | --Release announcement (not sure if we should do this) |-- FDSCo (or steering committee) | |--Charter | |--Meeting minutes | |--Elections | |--Nominations | --Task Schedule -- Workflow |--Docbook (how to write + intro) |--CVS (usage) |--Wiki (how to write) |--Publishing (web, PDF?) --Tools
And some general ideas: a) Create a default template for all Docs-related pages on the wiki (breadcrumb, default header, ...) to create a common look-and-feel b) Move everything in /Docs/Drafts to DocsProject/Drafts so users know that everything in /Docs is published documentation.
As I said, it's all just an idea / proposal. Comments?
As an exercise in -- I don't know, hubris? ignorance? -- I'm going to look at this list and make sugggestions, *completely blind* to the actual content of the current wiki.
1. Goals/Mission should be combined, cut down to a single concise paragraph or list, and appear on the front page.
2. The FDSCo/TaskSchedule stuff should be moved under the Schedule/ namespace. Everyone can work on these tasks, not just FDSCo members, and both the Publication Schedule and the DocTools Schedule should be linked or transcluded on the main schedule page.
3. The Workflow pages are a great asset and should relieve the Documentation Guide of some of its content. I think Karsten was in agreement with this point, since we worked on that some at FUDCon.
4. The browser splash page now exists, and there's probably no need to document it on the wiki -- we can use Bugzilla for RFE's or to track problems and to-do's.
5. There should perhaps be a Join item for Toolchain Builder.
That's all I have. This is a great goal and I would love to see people start cobbling on this stuff ASAP once we have buy-in from enough contributors. Bart, I think you just elected yourself point-man! :-)
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Paul W. Frields schreef:
On Fri, 2007-03-02 at 19:58 +0100, Bart Couvreur wrote:
[snip]
So here's a reorganization proposal:
DocsProject/ |-- Join | |--Writer | |--Editor | --Translator |-- Goals / Mission |-- Schedule | --some pages with details (e.g. specific schedules on DUG, IG) |-- Tasks (considering all FDP related tasks and processes) | |--Guides | |--Relnotes | |--Browser splash page | |--Plone | |--Ideas-page | --Release announcement (not sure if we should do this) |-- FDSCo (or steering committee) | |--Charter | |--Meeting minutes | |--Elections | |--Nominations | --Task Schedule -- Workflow |--Docbook (how to write + intro) |--CVS (usage) |--Wiki (how to write) |--Publishing (web, PDF?) --Tools
And some general ideas: a) Create a default template for all Docs-related pages on the wiki (breadcrumb, default header, ...) to create a common look-and-feel b) Move everything in /Docs/Drafts to DocsProject/Drafts so users know that everything in /Docs is published documentation.
As I said, it's all just an idea / proposal. Comments?
As an exercise in -- I don't know, hubris? ignorance? -- I'm going to look at this list and make sugggestions, *completely blind* to the actual content of the current wiki.
Yeah, that's the actual reason of the exercise, find out what works best without looking into what we have now.
- Goals/Mission should be combined, cut down to a single concise
paragraph or list, and appear on the front page.
+1
- The FDSCo/TaskSchedule stuff should be moved under the Schedule/
namespace. Everyone can work on these tasks, not just FDSCo members, and both the Publication Schedule and the DocTools Schedule should be linked or transcluded on the main schedule page.
True, this is the reason that I added some 'schedule-details' pages to the idea-tree.
- The Workflow pages are a great asset and should relieve the
Documentation Guide of some of its content. I think Karsten was in agreement with this point, since we worked on that some at FUDCon.
Good idea.
- The browser splash page now exists, and there's probably no need to
document it on the wiki -- we can use Bugzilla for RFE's or to track problems and to-do's.
Bugzilla could be workable, but it's easier for externals to the project to add ideas to a wiki-page, imo. Dimitris what's your point of view about this?
- There should perhaps be a Join item for Toolchain Builder.
That's all I have. This is a great goal and I would love to see people start cobbling on this stuff ASAP once we have buy-in from enough contributors. Bart, I think you just elected yourself point-man! :-)
Don't shoot the point-man! Sure, I'm willing to spearhead the effort :-)
Bart
- -- Bart couf@fedoraproject.org couf@skynet.be key fingerprint: 6AAB 544D 3432 D013 776D 3602 ADB6 6B2A D93F 0F93
O/H Bart Couvreur έγραψε:
Hey *,
in spite of the recent "Docs Project Structure" mail, I've been trying to get my head around the wiki-space we own.
People who want to see how - should I call it unorganized? - our project's pages are, go to the DocsProject page and add anything to the url that doesn't exist, it'll give you a list of all pages beneath DocsProject/ (e.g. fp.o/wiki/DocsProject/foo)
So here's a reorganization proposal:
DocsProject/ |-- Join | |--Writer | |--Editor | --Translator |-- Goals / Mission |-- Schedule | --some pages with details (e.g. specific schedules on DUG, IG) |-- Tasks (considering all FDP related tasks and processes) | |--Guides | |--Relnotes | |--Browser splash page | |--Plone | |--Ideas-page | --Release announcement (not sure if we should do this) |-- FDSCo (or steering committee) | |--Charter | |--Meeting minutes | |--Elections | |--Nominations | --Task Schedule -- Workflow |--Docbook (how to write + intro) |--CVS (usage) |--Wiki (how to write) |--Publishing (web, PDF?) --Tools
Seems like a good idea. Would require some work though: pages renamed and `#REDIRECT` statements put in the old ones, making sure links are changed etc. Take a look at the FUDCon Boston brainstorming [1] page and the recent Artwork Team page redesign process [2].
[1]: http://fedoraproject.org/wiki/Websites/MainPageRedesign2007 [2]: http://fedoraproject.org/wiki/ArtTeam
Some other suggestions:
* Add "Various" for misc stuff * Rename Schedule to Roadmap? * Add a "Requests" page, as in RFE/bugs.
And some general ideas: a) Create a default template for all Docs-related pages on the wiki (breadcrumb, default header, ...) to create a common look-and-feel
This is something me and Mairin were talking about: introduce page templates in various parts of the wiki. It would be a good idea to
b) Move everything in /Docs/Drafts to DocsProject/Drafts so users know that everything in /Docs is published documentation.
Not sure this is worth the effort. :/
-d
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Dimitris Glezos schreef:
O/H Bart Couvreur έγραψε:
[snip]
So here's a reorganization proposal:
DocsProject/ |-- Join | |--Writer | |--Editor | --Translator |-- Goals / Mission |-- Schedule | --some pages with details (e.g. specific schedules on DUG, IG) |-- Tasks (considering all FDP related tasks and processes) | |--Guides | |--Relnotes | |--Browser splash page | |--Plone | |--Ideas-page | --Release announcement (not sure if we should do this) |-- FDSCo (or steering committee) | |--Charter | |--Meeting minutes | |--Elections | |--Nominations | --Task Schedule -- Workflow |--Docbook (how to write + intro) |--CVS (usage) |--Wiki (how to write) |--Publishing (web, PDF?) --Tools
Seems like a good idea. Would require some work though: pages renamed and `#REDIRECT` statements put in the old ones, making sure links are changed etc.
Is there a way to see which pages links to a certain page? I remember seeing such a function, but can't find it anymore.
Take a look at the FUDCon Boston brainstorming [1] page and the recent Artwork Team page redesign process [2].
Some other suggestions:
- Add "Various" for misc stuff
Right
- Rename Schedule to Roadmap?
Well, I would use the Schedule place to keep everything that has to happen (tasks, deadlines etc), not sure if that's a real roadmap + everywhere else on the wiki the term Schedule is used (consistency).
- Add a "Requests" page, as in RFE/bugs.
Or a link to the Bugzilla component?
And some general ideas: a) Create a default template for all Docs-related pages on the wiki (breadcrumb, default header, ...) to create a common look-and-feel
This is something me and Mairin were talking about: introduce page templates in various parts of the wiki. It would be a good idea to
Great, IMO it helps a lot in keeping the projects pages consistent in style and format.
b) Move everything in /Docs/Drafts to DocsProject/Drafts so users know that everything in /Docs is published documentation.
Not sure this is worth the effort. :/
Heh, yeah, on second thought it would be a very very big thing to move, scratch one idea :-)
-d
- -- Bart couf@fedoraproject.org couf@skynet.be key fingerprint: 6AAB 544D 3432 D013 776D 3602 ADB6 6B2A D93F 0F93
-
Bart Couvreur -
Dimitris Glezos -
Paul W. Frields