Re: [VOTE] Release Velocity DocBook Framework 1.0
So, did this get released? I I've been working in DocBook myself lately. -Ted. On 3/21/07, Henning Schmiedehausen [EMAIL PROTECTED] wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
+1 On 3/21/07, Henning Schmiedehausen [EMAIL PROTECTED] wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
Hi everyone - The UIMA project has embraced the docbook process, starting with setup that Velocity had. We use it to produce our documentation in HTML (single) and PDF. We've perhaps improved it in some small ways, but haven't found the time to clean up what we've done quite yet. I would suggest if we had a little more time, to transfer whatever of these improvements to this project. The improvements include things like making xi:includes work, moving to FOP 0.93 and the latest docbook level (actually, supporting multiple levels), having the distr not contain some of the publically available tools, but instead downloading them on first use, only unpacking zip files once, etc. (Some of these things you may have done already... but I've not been tracking since we started with your tooling). -Marshall Schor Henning Schmiedehausen wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
+1 from me. Looking forward to seeing this approach become more widely adopted. WILL On 3/22/07, Henning P. Schmiedehausen [EMAIL PROTECTED] wrote: Will Glass-Husain [EMAIL PROTECTED] writes: While I think a point by point debate would be silly, I think it'd be really useful if you could restate to the list why you are dissatisified with the current choices for docs, and why this approach is so much better. If I understand your main argument, it's essentially better tools available and more standard format. Is that fair? * Tried and true format, used in tons of projects. Standing on others' shoulders. * Wide range of tool support up to WYSIWYG editors. * Much more options and formatting than XDoc. * Non-technical contributors that are willing to work on docs can do so without having do dig through Doxia / Anakia sources to find out how to format a section. * Printable formats. If you don't believe this an advantage, look at the amount of printouts the guy next to you has on his table. Folks, what is this? This code has been in Subversion for ages. I've posted a number of snapshots to this list and got close to no reactions. Why didn't you speak up in sometime the last six months? I would have been more than happy to discuss all of this *before* voting. Best regards Henning -- Henning P. Schmiedehausen -- [EMAIL PROTECTED] | J2EE, Linux, |gls 91054 Buckenhof, Germany -- +49 9131 506540 | Apache person |eau Open Source Consulting, Development, Design| Velocity - Turbine guy |rwc |m k INTERMETA - Gesellschaft fuer Mehrwertdienste mbH - RG Fuerth, HRB 7350 |a s Sitz der Gesellschaft: Buckenhof. Geschaeftsfuehrer: Henning Schmiedehausen |n Save the cheerleader. Save the world. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Forio Business Simulations Will Glass-Husain [EMAIL PROTECTED] www.forio.com - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
it is always wise to run in the opposite direction to get next door On Thu, 22 Mar 2007 19:08:57 -0400, Henning P. Schmiedehausen [EMAIL PROTECTED] wrote: Marshall Schor [EMAIL PROTECTED] writes: Hi everyone - The UIMA project has embraced the docbook process, starting with setup that Velocity had. We use it to produce our documentation in HTML (single) and PDF. We've perhaps improved it in some small ways, but haven't found the time to clean up what we've done quite yet. I would suggest if we had a little more time, to transfer whatever of these improvements to this project. The improvements include things like making xi:includes work, moving to FOP 0.93 and the latest docbook level (actually, supporting multiple levels), having the distr not contain some of the publically available tools, but instead downloading them on first use, only unpacking zip files once, etc. (Some of these things you may have done already... but I've not been tracking since we started with your tooling). Terrific! I did not know about that. If you give me an URL / location for this, we can collaborate on merging this back. Personally I would prefer to do this post-1.0, mainly to establish a baseline which can be used for others to start without having to check out from the Repository. If you branched off an earlier version, it is probably interesting for you that the current setup is much less intrusive than the old version used to be: You can now have a single install of the framework for any number of docs without having to have multiple copies of it. I see the DBF branch out of Velocity at some point in the future. I was thinking labs but as lab projects are actually not allowed to do formal releases, this might not be the right place and there is no real project inside Apache charged with tooling and/or documentation. So it will rest inside Velocity for the time being. Best regards Henning -Marshall Schor Henning Schmiedehausen wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Using Opera's revolutionary e-mail client: http://www.opera.com/mail/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
This makes a lot of sense to me. Released projects have visibility (and an implied ease-of-use) that a labs type effort does not. I think you'll be more likely to get adoption (and contributions) as a visible subproject of Velocity. Nice documentation, by the way. (Like the PDF file). Though I guess that's the point. WILL On 3/22/07, Henning P. Schmiedehausen [EMAIL PROTECTED] wrote: I see the DBF branch out of Velocity at some point in the future. I was thinking labs but as lab projects are actually not allowed to do formal releases, this might not be the right place and there is no real project inside Apache charged with tooling and/or documentation. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
On Wed, 21 Mar 2007 18:07:46 -0400, Henning Schmiedehausen [EMAIL PROTECTED] wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] u... 'bored out of my mind' after taking a very simple thing and making it extremely complicated -- how we feel s sorrr for you The problems with rendering a simple HTML website do not(!) lie with XSL and XML. They lie with the person who has chosen the XML structure and the build system. u... f***ing again. This is so lame. I wrote an XSL in about 10 minutes that would have handled the existing XDocs and posted it to this or the user list (don't remember when and won't search the archives for it). Seriously, this is disgraceful. Does a comitter ever lose their status other than resigning it? Doesn't this call for a dismissal??? I feel like moving over to freemarker :-) (what emoticon do you use to represent contemptful sarcasism with humor and disgust) whatev This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Using Opera's revolutionary e-mail client: http://www.opera.com/mail/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
On 3/21/07, Robert Koberg [EMAIL PROTECTED] wrote: On Wed, 21 Mar 2007 18:07:46 -0400, Henning Schmiedehausen [EMAIL PROTECTED] wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] u... 'bored out of my mind' after taking a very simple thing and making it extremely complicated -- how we feel s sorrr for you The problems with rendering a simple HTML website do not(!) lie with XSL and XML. They lie with the person who has chosen the XML structure and the build system. snip-rant/ Please try to phrase your responses in a productive fashion. If you feel strongly, the -1 option in the ballot is always available for constructive feedback. -Rahul This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: [VOTE] Release Velocity DocBook Framework 1.0
Ouch - that's a pretty unfriendly and non-productive email. Henning, you made a great case for DocBook at ApacheCon US 2006 in your lightning talk. I'm looking forward to downloading and taking a look at your proposed release. While I think a point by point debate would be silly, I think it'd be really useful if you could restate to the list why you are dissatisified with the current choices for docs, and why this approach is so much better. If I understand your main argument, it's essentially better tools available and more standard format. Is that fair? WILL On/21/07, Robert Koberg [EMAIL PROTECTED] wrote: On Wed, 21 Mar 2007 18:07:46 -0400, Henning Schmiedehausen [EMAIL PROTECTED] wrote: [Let's say, it will not get better and I'm already bored out of my mind again tinkering with XSL and XML.] u... 'bored out of my mind' after taking a very simple thing and making it extremely complicated -- how we feel s sorrr for you The problems with rendering a simple HTML website do not(!) lie with XSL and XML. They lie with the person who has chosen the XML structure and the build system. u... f***ing again. This is so lame. I wrote an XSL in about 10 minutes that would have handled the existing XDocs and posted it to this or the user list (don't remember when and won't search the archives for it). Seriously, this is disgraceful. Does a comitter ever lose their status other than resigning it? Doesn't this call for a dismissal??? I feel like moving over to freemarker :-) (what emoticon do you use to represent contemptful sarcasism with humor and disgust) whatev This is the CfV for the first release of the Velocity DocBook Framework. It is intended for creating and maintaining high quality documentation generated in the DocBook format. The framework itself is completely generic, non-intrusive, 100% bio-degradable and environment-friendly. The release candidate is available from http://people.apache.org/~henning/DocBook-Framework/ The documentation (which also serves as showcase example is visible at http://people.apache.org/~henning/DocBook-Framework/DocBook-Framework-1.0.pdf) [ ] +1 Let's do it [ ] 0 I don't care. [ ] -1 No, because __ Voting period is until Sunday, March 25th, 2007, 12:00 CEST ( 72h). My vote is +1 Best regards Henning - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Using Opera's revolutionary e-mail client: http://www.opera.com/mail/ - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Forio Business Simulations Will Glass-Husain [EMAIL PROTECTED] www.forio.com - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
