Op wo 02-07-2003, om 21:18 schreef Kevin Mark: > > <snip> > > I wrote the documentation > > for myself and have offered it to the open source community as a > > "here you might find this useful" kind of document. I was then asked > > by one debian user to contribute my documentation to The LDP. > > The submission process involved doing a re-write of my original text and > > converting the document from valid XHTML to DocBook, a markup language that I > > have learned for this project. I'm now working on revising the LDP XSLT > > templates (and possibly DocBook templates from a debian package) > > to correct the HTML output so that my document will validate when > > it is translated BACK to HTML. > <snip> > Hi EJH, > a recent discussion on another list I am on mentioned frustrations at > the LDP for many of the same reasons: converting it to the 'not simple > for beginners format' Docbook - which they said the LDP did not provide > an 'example' to get a quick start. The idea of having possibly useful > info, tips, what-not and having so many barriers to 'contribute'. Seem > like they should have someone at LDP or similar to do the rough > conversion since its what they want and will be checking anyway and will > be expert creating. I hate the idea of people wishing to contribute only > to be thwarted by 'process'. > just my 2 yen. > -K > Emma, i'm with Kevin. It's great that you looked into making a doc for the LDP but if it was me who made the original doc, i wouldn't have bothered writing a doc in some scripting language (or whatever Docbook is). It's already an effort that you decided to write down your experiences so other people could benefit from it. And a lot of people already know your site so they can check the documents there. I for one have never liked the format of the LDP project. It's doesn't read easily. And they should accept HTML docs. You provided the research and the knowledge, they can provide the layout. If not, to bad they loose out on some great material. And people do appreciate what you are doing. It's not because some people aren't that enthousiastic that the better part of this community isn't excited about it. Regards, Benedict
Attachment:
signature.asc
Description: Dit berichtdeel is digitaal gesigneerd