User Guide status?

Betty Harvey harvey at eccnet.com
Tue Jan 6 19:43:03 UTC 2009


<quote who="Matthew Daniels">

> I say +1 on straight to XML.  Despite the fact that it will have a
> slightly larger learning curve than editing on the wiki, I would love
> to get rid of the conversion process and make sure everything is nice
> right on the XML document.  I think that'll be much cleaner in
> general, especially since everyone will have to be looking at the
> final document (as opposed to everyone writing on the wiki and then a
> specialized conversion team generating the final copy).  I'll have to
> learn just as much (and probably more) than a lot of us to do it this
> way, but I think it's worth it.  Plus, it could get newer team members
> familiar with git and XML so they can help on other docs.
>

I agree with going to straight XML.  One of the "gotcha's" that I found
with extracting the data from the WIKI is that it does not extract
warnings, cautions and notes.  As such it required manual intervention.

I am not sure if anyone is willing to move away from the WIKI but Drupal
has a module that allows native XML and rendering via a stylesheet.  I
am using it with a modified version of Docbook and XSLT.  It works great.

Betty

> -- Matthew
>
> --
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe:
> https://www.redhat.com/mailman/listinfo/fedora-docs-list
>


/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
Betty Harvey                         | Phone: 410-787-9200 FAX: 9830
Electronic Commerce Connection, Inc. |
harvey at eccnet.com                    | Washington,DC SGML/XML Users Grp
URL:  http://www.eccnet.com          | http://www.eccnet.com/xmlug/
/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\\/\/




More information about the fedora-docs-list mailing list