On Fri, 2007-03-02 at 14:14 +0000, Dimitris Glezos wrote:
I think we should really try to find a way not only to create our
docs online
but to also *maintain* them. "Wiki -> XML" is indeed great, but unless we
get it
as much automated as possible, the overhead is a nightmare.
One concern is that we are creating two classes of document -- static
formal publications and appears-to-be-dynamic because it is published at
wiki/Docs.
The overhead to produce and maintain the static content is considerable,
compared to the Wiki. However, the Wiki is trapping -- it makes you
comfortable with its workings, your content gets trapped there in a way
that is increasingly difficult to extract, it's nearly impossible to
localize with Fedora L10n tools, etc.
This is why, despite the pain, I've been driving us toward a "Wiki as
$EDITOR" approach. Unfortunately, doing this requires more resources
doing Web app programming, and that is not a big skill in this project.
So, our project is vying for resources in Infrastructure and Websites.
We could choose to go backward/sideways from here and make it all Wiki.
Or ...
Well, the point is, it is always open for discussion what we can and
should do.
- Karsten
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. |
fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\