[Improving Boost Docs] Help Request, Boost specific WikiMacros

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view

[Improving Boost Docs] Help Request, Boost specific WikiMacros

Matias Capeletto
Note: This message is part of a series of "Help request" posts. We
need cool guys to help us in the docs project. There are some
interesting task that may be done by one or two folks, and that will
really help that this project comes up well. There are no time frames,
just a bunch of people with different paces working together to make
boost docs better. I am sending this message to the boost devel list
to reach more hands. If you are interested (please be!) move further
discussion to the boost-docs list. Thanks!


Trac Wiki allows the use of macros [1] to help with common needs like
a TOC or the insertion of a n image. They work similarly to Quickbook
There are only a bunch of them in the official Trac release, and it
will be very helpful to have a set of boost specific macros that makes
common things like referring to a particular section of boost docs
very easy ( something like [[BoostDocSection(regex,introduction)]] )

This project will have two tasks:

* Investigate current official Macros [1] and not so official macros
[2] to look for the things we may find useful ( See [a],[b],[c],[d]
and [e] for some examples I find cool)

* Write a not too clutter proposal for new Boost specific WikiMacros,
including the rationale behind each decision.

* Implement the Macros specified in the proposal. Luckily Trac uses
Python for this! [3]

If you want to participate in the project, jump in!
We are eagerly waiting for you.

Best regards

[1] http://svn.boost.org/trac/boost/wiki/WikiMacros

[2] http://trac.edgewall.org/wiki/MacroBazaar
      [a] http://trac.edgewall.org/wiki/MacroBazaar#Includes
      [b] http://trac.edgewall.org/wiki/MacroBazaar#LastModified
      [c] http://trac.edgewall.org/wiki/MacroBazaar#AddComment
      [d] http://trac.edgewall.org/wiki/MacroBazaar#FootNote
      [e] http://trac.edgewall.org/wiki/MacroBazaar#RSSget
      [f] http://trac.edgewall.org/wiki/MacroBazaar#VisitCounter

[3] http://svn.boost.org/trac/boost/wiki/WikiMacros#DevelopingCustomMacros

This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
Boost-docs mailing list
[hidden email]
Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs