Authors of libraries with html based docs, please read

Hi! We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work. The only thing you will have to do is to edit .qbk files instead of .html files the next time you have to change your docs. Believe me when I say that it is very very easy to learn (ask anyone about this), your docs will be more maintainable and documenting will start to be a fun part of your boost work. After the translation we offer our time to help you learning Quickbook. We have two volunteers (Jake and Glyn) that are eagerly waiting for a first victim :) They are sending private email to authors but it will be nice to have a TODO list of docs to convert. Please tell us if we can help you. Thanks for helping us improve boost documentation Best Regards Matias

Hi, Matias Capeletto wrote:
Hi!
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work. The only thing you will have to do is to edit .qbk files instead of .html files the next time you have to change your docs. Believe me when I say that it is very very easy to learn (ask anyone about this), your docs will be more maintainable and documenting will start to be a fun part of your boost work. After the translation we offer our time to help you learning Quickbook.
We have two volunteers (Jake and Glyn) that are eagerly waiting for a first victim :) They are sending private email to authors but it will be nice to have a TODO list of docs to convert.
Please tell us if we can help you.
What about the libraries that have the documentation in the plain boostbook + doxygen? Regards, Pavol.

On 6/20/07, Pavol Droba <droba@topmail.sk> wrote:
Hi,
Hi Pavol,
Matias Capeletto wrote:
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
Please tell us if we can help you.
What about the libraries that have the documentation in the plain boostbook + doxygen?
html based docs have higher priority but It will rock to have everything under Quickbook umbrella. I add string_algo to the translation queue if you want. Best regards Matias

Hi Matias Capeletto wrote:
What about the libraries that have the documentation in the plain boostbook + doxygen?
html based docs have higher priority but It will rock to have everything under Quickbook umbrella. I add string_algo to the translation queue if you want.
Feel free to do it whenever you want. I have nothing against it. Regards, Pavol.

On Wed, 2007-06-20 at 12:43 -0300, Matias Capeletto wrote:
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
Yep, that's really slick. You have my permission to convert any of the libraries I authored or maintain to Quickbook. That matters for: Graph: It's huge, and it's HTML. Function: In BoostBook now, so don't bother converting yet Signals: In BoostBook now, so don't bother converting yet Tribool: In BoostBook now, so don't bother converting yet You don't need to touch MPI; it's already Quickbook+Doxygen. - Doug

Douglas Gregor wrote:
You have my permission to convert any of the libraries I authored or maintain to Quickbook. That matters for:
Graph: It's huge, and it's HTML. Function: In BoostBook now, so don't bother converting yet Signals: In BoostBook now, so don't bother converting yet Tribool: In BoostBook now, so don't bother converting yet
Added to the wiki. Regards Matias

Hi Matias, I'll be happy to be a Guineapig for this translation effort! Please tell me if I can assist you in any way to convert my Wave docs to Quickbook! Regards Hartmut
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Matias Capeletto Sent: Wednesday, June 20, 2007 10:43 AM To: boost@lists.boost.org Subject: [boost] Authors of libraries with html based docs, please read
Hi!
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work. The only thing you will have to do is to edit .qbk files instead of .html files the next time you have to change your docs. Believe me when I say that it is very very easy to learn (ask anyone about this), your docs will be more maintainable and documenting will start to be a fun part of your boost work. After the translation we offer our time to help you learning Quickbook.
We have two volunteers (Jake and Glyn) that are eagerly waiting for a first victim :) They are sending private email to authors but it will be nice to have a TODO list of docs to convert.
Please tell us if we can help you.
Thanks for helping us improve boost documentation Best Regards Matias _______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

On 6/20/07, Hartmut Kaiser <hartmut.kaiser@gmail.com> wrote:
Hi Matias,
Hi Harmut!
I'll be happy to be a Guineapig for this translation effort! Please tell me if I can assist you in any way to convert my Wave docs to Quickbook!
Thanks! Do you want us to translate your docs or you can help us? If you want to translate your own docs, it will be great. We offer you any kind of help you need in the process. Best regards Matias

Matias,
I'll be happy to be a Guineapig for this translation effort! Please tell me if I can assist you in any way to convert my Wave docs to Quickbook!
Thanks! Do you want us to translate your docs or you can help us? If you want to translate your own docs, it will be great. We offer you any kind of help you need in the process.
It would be just great if you could do it. If you have any questions I'll be happy to assist. Regards Hartmut

Matias Capeletto wrote:
Hi!
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work. The only thing you will have to do is to edit .qbk files instead of .html files the next time you have to change your docs. Believe me when I say that it is very very easy to learn (ask anyone about this), your docs will be more maintainable and documenting will start to be a fun part of your boost work. After the translation we offer our time to help you learning Quickbook.
We have two volunteers (Jake and Glyn) that are eagerly waiting for a first victim :) They are sending private email to authors but it will be nice to have a TODO list of docs to convert.
Please tell us if we can help you.
Thanks for helping us improve boost documentation
Spirit begat quickdoc, then quickbook, precisely because writing the docs was a pain. Yet, Spirit (1) is still in html while all its siblings (fusion, phoenix) are now in quickbook. I'd be very happy if someone can do a transformation of the spirit docs to quickbook. Regards, -- Joel de Guzman http://www.boost-consulting.com http://spirit.sf.net

On 6/20/07, Joel de Guzman <joel@boost-consulting.com> wrote:
Matias Capeletto wrote:
Thanks for helping us improve boost documentation
Spirit begat quickdoc, then quickbook, precisely because writing the docs was a pain. Yet, Spirit (1) is still in html while all its siblings (fusion, phoenix) are now in quickbook. I'd be very happy if someone can do a transformation of the spirit docs to quickbook.
Great! I add it to the queue. I want to thanks GSoCers for jumping in and help us with the translation. (three of the four volunteers are from this year GSoC!) Best regards Matias

Matias Capeletto wrote:
On 6/20/07, Joel de Guzman <joel@boost-consulting.com> wrote:
Matias Capeletto wrote:
Thanks for helping us improve boost documentation Spirit begat quickdoc, then quickbook, precisely because writing the docs was a pain. Yet, Spirit (1) is still in html while all its siblings (fusion, phoenix) are now in quickbook. I'd be very happy if someone can do a transformation of the spirit docs to quickbook.
Great! I add it to the queue.
I want to thanks GSoCers for jumping in and help us with the translation. (three of the four volunteers are from this year GSoC!)
THANK YOU! You guys are soooo coool! Special thanks to you, Matias. Your work the past few weeks is no less than splendid! Regards, -- Joel de Guzman http://www.boost-consulting.com http://spirit.sf.net

On 6/24/07, Beman Dawes <bdawes@acm.org> wrote:
Matias Capeletto wrote:
... The only thing you will have to do is to edit .qbk files instead of .html files the next time you have to change your docs.
Is there a WYSIWYG editor available for Windows?
No (yet). AFAICS The tools developed to aid Quickbook editing so far are: SciTe editor support http://tinyurl.com/34oqkt KDE support http://tinyurl.com/2ll5tk Html to Quickbook conversion (Using firefox: Menu: "View"-->"Page Style"-->"Quickbook source") http://tinyurl.com/27ubvp We are working hard to make things easy, expect more tools to pop up soon. Best regards Matias

Hi Matias
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work.
Sounds good to me :-), I hereby grant you the permission to convert all the Boost.Statechart docs. I think we should do this iteratively, so please get back to me as soon as you have converted a few pages worth. Also, please let me know before you start so that I can check in everything. Thanks! Best Regards, -- Andreas Huber When replying by private email, please remove the words spam and trap from the address shown in the header.

On 6/27/07, Andreas Huber <ahd6974-spamboostorgtrap@yahoo.com> wrote:
Hi Matias
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work.
Sounds good to me :-), I hereby grant you the permission to convert all the Boost.Statechart docs.
Thanks! I will add you to the queue.
I think we should do this iteratively, so please get back to me as soon as you have converted a few pages worth. Also, please let me know before you start so that I can check in everything. Thanks!
Do not worry, I will contact you offline. Best regards Matias

Sent from my iPhone On Jun 30, 2007, at 9:41 AM, "Matias Capeletto" <matias.capeletto@gmail.com
wrote:
On 6/27/07, Andreas Huber <ahd6974-spamboostorgtrap@yahoo.com> wrote:
Hi Matias
We are trying to convert every bit of boost docs to Quickbook so we can handle them easier and apply a new set of features that we have been developing. If you want to look at the last iteration of the new style, it is here: http://tinyurl.com/3yukos
We need your authorization to help you in the translation process. It will be painless for you because we will translate your docs to Quickbook and do all the hard work.
Sounds good to me :-), I hereby grant you the permission to convert all the Boost.Statechart docs.
Thanks! I will add you to the queue.
I think we should do this iteratively, so please get back to me as soon as you have converted a few pages worth. Also, please let me know before you start so that I can check in everything. Thanks!
Do not worry, I will contact you offline.
Best regards Matias _______________________________________________ Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

on Wed Jun 20 2007, "Matias Capeletto" <matias.capeletto-AT-gmail.com> wrote:
Please tell us if we can help you.
It would be great if the Boost.Python docs were translated. Thanks for everything you're doing! -- Dave Abrahams Boost Consulting http://www.boost-consulting.com The Astoria Seminar ==> http://www.astoriaseminar.com

On 7/2/07, David Abrahams <dave@boost-consulting.com> wrote:
on Wed Jun 20 2007, "Matias Capeletto" <matias.capeletto-AT-gmail.com> wrote:
Please tell us if we can help you.
It would be great if the Boost.Python docs were translated.
Added to the queue. Thanks David.
Thanks for everything you're doing!
It is not only me... we have to build up a collaborative net, if not the project will fail. Thanks go to all these cool folks too: Andrew Sutton Cédric Venet Darren Garvey Douglas Gregor Eric Niebler Filip Konvička Glyn Matthews Jacob Robert Voytko Joel de Guzman John Maddock Paul Bristow Peter Foley Rene Rivera Stjepan Rajko Stuart Dootson King regards Matias
participants (9)
-
Andreas Huber
-
Beman Dawes
-
David Abrahams
-
David Bergman
-
Douglas Gregor
-
Hartmut Kaiser
-
Joel de Guzman
-
Matias Capeletto
-
Pavol Droba