[[Image(ibdp.png,nolink)]] * [ImprovingBoostDocs Improving Boost Docs] * '''[ImprovingBoostDocs About this project]''' * [BoostDocsRepository Boost docs repository] * [UnifiedLookAndFeelProject Unified look and feel project] * [HelpingBoostAuthors Helping Boost Authors] * [GlueDocsProject Glue docs project] * [StandardCppLibraryDocumentation Standard C++ Library Docs] * [DocumentationBestPractices Documentation Best Practices] * [DocumentationTools Documentation Tools] * [ImprovingBoostDocsSubprojects Subprojects] * [BrowserTestingChart Browser Testing Chart] * [LibrariesLogos Logo Playground] ---- [[PageOutline(2-5,Table of contents,inline)]] ---- == Objectives == [[Image(CommonImages:design.png,nolink)]] * Build up a long-term community of people who care and constantly improve Boost documentation and tools. * Achieve an unified look and feel between docs and Boost resources, integrating them as much as possible. * Quality documentation [[Br]][[Br]] * Provide correct, current and readable documentation for Boost C++ libraries, tools, environment and organization. [[Br]][[Br]] * Generate Glue docs that see Boost as one unified entity, providing real-world examples, best practices for common tasks and tutorials on how to combine Boost libraries in order to build high-quality C++ applications. [[Br]][[Br]] * Provide a publicly available, vendor-neutral reference manual for the standard C++ library, STL concepts, data types and algorithms as part of the Boost library documentation. [[Br]][[Br]] * Make it easier for users to navigate the enormous amount of Boost documentation. [[Br]][[Br]] * Use the latest version of standards and support old browsers. [[Br]][[Br]] * Include attractive logos and diagrams. Although Boost libraries are of such good quality that they do not need any marketing at all, let's face it: people are drawn to fancy names and eye-catching pictures. * Documentation tools and support [[Br]][[Br]] * Improve the docs tool chain, simplifying and integrating it, thereby lowering the barrier for people willing to help us. [[Br]][[Br]] * Develop tools to automate common tasks and to make life easier for Boost authors. Document writers should concentrate on generating content and not on fighting with tools. [[Br]][[Br]] * Work to make doc tools Boost-agnostic. We believe that they are useful beyond the Boost community and would welcome anyone who wishes to use, extend or support them. * Generate formal documents about C++ documentation best practices. * Offer our help to library authors. This includes translations, proof-reading, proposing examples and tutorials for their libraries and helping them with the docs tool chain. * Offer a place where those who are not experts in C++ can help the Boost community. In general, the tasks we do here do not involve template metaprogramming or other complex C++ machinery. Dessigners, artists, teachers, web experts, Python programmers and Boost users are very welcome to contribute. * Write docs, include rationales, use our own tools. If we want to improve boost docs, we should start by showcasing best practices in this project. * Enjoy our work. If we are not having fun while improving Boost docs something has gone terribly wrong. ---- == Resources == [[Image(CommonImages:resources.png,nolink)]] At IBD, we use several open-source tools to organize our efforts. In this section the purpose of each resource is explained. When possible, IBD resources will be interlinked and have a common look and feel, allowing a consistent experience for both users and developers. Although the only resources that every IBD developer must use are the Boost docs subversion repository, the Boost docs list and the project wiki, we encourage you to read this section and use the rest of the tools; combined, they are a complete community development suite. === Project output === [[Image(CommonImages:logo_subversion.png,nolink)]] [[Br]]'''[http://svn.boost.org/trac/boost/wiki/BoostDocsRepository Subversion repository]''' [[Br]] Our version control system. It is integrated to Trac allowing you to browse the code [http://svn.boost.org/trac/boost/browser/sandbox/boost_docs from the Web]. [[Image(CommonImages:logo_vault.png,nolink)]] [[Br]]'''[http://tinyurl.com/2nvty4 Boost Vault]''' [[Br]]Boost Docs and subproject releases Glue Docs Vault. [[Br]]It has an integrated counter so we can track how many people are using our work. [[Image(CommonImages:logo_docs.png,nolink)]] [[Br]]'''[http://beta.boost.org/development/doc/doc_test/doc/html/index.html On-line Docs]''' [[Br]]We maintain an online version of the documentation that already conforms to the new documentation guidelines. [[Br]] === Communication channels === [[Image(CommonImages:logo_ibdwiki.png,nolink)]] [[Br]]'''[http://svn.boost.org/trac/boost/wiki/ImprovingBoostDocs#ProjectWiki Project Wiki]''' [[Br]]Main organization tool. [[Br]]This contains formal information about subprojects and the work being done by each developer. [[Br]]The main purposes are to showcase our progress and to avoid work duplication. [[Br]]It has a structured layout to organize our workflow. New project ideas are not added directly, but rather after thoughtful discussion on other channels. [[Image(CommonImages:logo_gmane.png,nolink)]] [[Br]]'''[http://dir.gmane.org/gmane.comp.lib.boost.documentation Boost-docs list]''' [[Br]]This is were the actual work is shared and discussed. It acts as the boost-devel mailing list for our project. [[Br]]Mailing lists are a good medium for daily work. It is a working space. All our progress must pass through the boost-docs list to be viewed by every person involved in the project. [[Br]]You can sign in [http://lists.boost.org/mailman/listinfo.cgi/boost-docs here]. [[Image(CommonImages:logo_trac.png,nolink)]] [[Br]]'''[http://svn.boost.org/trac/boost/report Trac Tickets system]''' [[Br]]We are currently working on a formal proposal to take advantage of Trac Ticket system for the project. [[Br]]We will use it for translation tracking, subproject control, feature requests and bug reporting. [[Image(CommonImages:logo_rss.png,nolink)]] [[Br]]'''[http://beta.boost.org/development/ibd_news.rss RSS news feed]''' [[Br]]The IBD news feed consists of formal announcements about the things going on in the project. They are very short, direct headlines. [[Br]]Some of the common subjects are new members, new subprojects, help requests and completed translation. [[Br]] === Community-building tools === [[Image(CommonImages:logo_blogger.png,nolink)]] [[Br]]'''[http://improving-boost-docs.blogspot.com Community Blog]''' [[Br]]A record of the things that happen behind the scenes, our next objectives and the social and philosophical aspects of IBD. [[Br]]The subjects of the Blog are things like summaries of private conversations, possible directions for the project and new ideas. [[Br]]It includes behind-the-scenes content. It is a place where you can see what is going on in the developer's mind and a tool to make us a tidy community by giving contributors an informal forum in which to express themselves. [[Br]]There is a precedent of using blogs for philosophical discussions, and it is a lot easier for people not related to the project to comment on our progress there. We encourage you to participate both as a blogger or by commenting on our posts. [[Image(CommonImages:logo_irc.png,nolink)]] [[Br]]'''[irc://irc.freenode.net/ibd IBD IRC channel]''' [[Br]]IBDers hang out in this channel. It has an informal and very enjoyable ambient. If something interesting is discussed there, it is edited and posted in the boost-docs list or our community blog. The channel name is #ibd and is being hosted in irc.freenode.net. We are waiting you there. If you have an IRC capable browser you can directly use [irc://irc.freenode.net/ibd the IRC url]. [[Image(CommonImages:logo_linkedin.png,nolink)]] [[Br]]'''[http://www.linkedin.com/ Linked in network]''' [[Br]]A service for maintaining professional networks. We will use it to organize our contacts from the project. [[Br]] === Statistics === [[Image(CommonImages:logo_ohloh.png,nolink)]] [[Br]]'''[http://www.ohloh.net/projects/6385 IBD at ohloh]''' [[Br]]Statistics on our project, code and contributors. [[Br]]It offers a stack and kudos system too, which can be used as community-building tools. [[Image(CommonImages:logo_statcounter.png,nolink)]] [[Br]]'''[http://my.statcounter.com/project/standard/stats.php?project_id=2713553&guest=1 Statcounter]''' [[Br]]Web page activity statistics. [[Br]]Currently these are integrated into the community blog only. In the future, we will gather information from the main page of Boost's website, the wiki pages and Boost's online documentation. [[Image(CommonImages:logo_gmane.png,nolink)]] [[Br]]'''[http://gmane.org/plot-rate.php?group=gmane.comp.lib.boost.documentation List activity]''' [[Br]]Messages per day plot of Boost-docs list. ---- == How to help == [[Image(CommonImages:help_wanted.png,nolink)]] There are some small projects waiting for one or two people to take on. * Quickbook as a [WikiProcessors WikiProcessor] for our Trac ( [http://tinyurl.com/2l9qfy more information], [QuickbookWikiProcessor project wiki page] ) * Google Search Box project ( [http://tinyurl.com/2mfobx more information], [GoogleSearchBoxProject project wiki page] ) * Syntax-highlighting project ( [http://tinyurl.com/35g4fv more information], [SyntaxHighlightingProject project wiki page] ) Other ways to help us * Help building the Standard C++ Library Boosted Documentation ( More information in the [StandardCppLibraryDocumentation Standard C++ Library Docs page] ) * Volunteer as a browser tester ( More information in the [BrowserTestingChart browser testing chart page] ) * Document translator ( More information in the [DocsTranslationsProject docs translations project page] ) * Comment on our work. We need constant feedback. Please offer your opinion on the [https://lists.sourceforge.net/lists/listinfo/boost-docs boost-docs list]. * A lot of the documentation on this wiki is being written by a non-native English-speaker. Just reading and correcting typos and grammar will be appreciated. If you are... * ... a web designer, you can help us with our HTML docs projects. * ... an artist, you can propose graphics to make boost look fancier. * ... a teacher, you can write tutorials for the Glue Docs project. * ... a Boost user, you can provide us with real-life examples for the Glue Docs project. * ... a Python programmer, you can help us to integrate things into Trac. ---- == Downloads == [[Br]][[Image(boost_docs_2007-07-01.png,nolink)]] [[Br]] [[Br]]'''[http://boost-consulting.com/vault/index.php?action=downloadfile&filename=boost_docs_07_07_01.zip&directory=Improving%20Boost%20Docs& Boost Docs 2007-07-01 at Boost Vault]''' [[Br]]''svn export !http://svn.boost.org/svn/boost/sandbox/boost_docs/tags/boost_docs_2007-07-01'' '''Release notes''' * Initial version of Boost.!DocTest * Initial version of Boost Style * Modular CSS design. * CSS-based admonitions and navigation graphics. * Quickbook source stylesheet. * Boostbook improvements * Almost Valid XHTML 1.1 output. * New header and footer based on beta.boost.org. * !GroupedLinks select boxes for Boost Libraries and Section quick jumping. * Google Search box over our docs. * Box wrapper-based blurbs that allow us to include rounded corners, drop shadows, etc. * Alternative syntax-highlighting, including most common IDEs. * Chapter logo support. * Parameter clean-up. * A new PDF stylesheet based on the unified look-and-feel project. * Quickbook improvements * Initial support for SVG images in HTML docs. '''Installation Notes''' Copy the contents of the Boost Docs zipped file into an up-to-date Boost package. ---- == Project Wiki == [[Image(ibd_wiki.png,nolink)]] * '''[BoostDocsRepository Boost Docs repository]'''[[Br]] We are working on several Boost tools to support the new features and improve their usability. This work is stored in Boost's sandbox. Go to the Boost docs repository page to learn how it is organized. * '''[UnifiedLookAndFeelProject Unified look-and-feel project]'''[[Br]] Although Boost libraries are independent entities, together they build a superb, unified library. If we want people to understand this, we must provide an unified style for our docs and resources. This project will define the guidelines for the new look and feel of Boost. * '''[HelpingBoostAuthors Helping Boost Authors]'''[[Br]] This section is a bazaar of friendly hands. We are teachers, experience users, native English speakers and artists. We want to offer our help to Boost authors to improve their documentation. The main objective of this resource is to act as the main connection between Boost authors and some of IBD folks that are eager to help them. We hope this will make healthier the relation between Boost authors and our project. Authors will get helped, and have more time to improve and add new features to their libraries. We will get in touch with you and hopefully learn enough to become a boost author someday. It is a win-win situation. * '''[GlueDocsProject Glue Docs]'''[[Br]] Documentation for Boost libraries is an impressive tool for learning about how individual libraries work. However, we are missing integration documentation that sees Boost as a whole. How we do common tasks, which libraries are powerful when combined, and real-life examples are important documentation that we cannot expect Boost authors to provide. The objective of the Glue Docs project is to build the necessary meta-library documentation for Boost. * '''[StandardCppLibraryDocumentation Standard C++ Library Docs]'''[[Br]] Provide a publicly available, vendor-neutral reference manual for the Standard C++ library, STL concepts, data types and algorithms as part of the Boost library documentation. * '''[DocumentationBestPractices Documentation Best Practices]'''[[Br]] Formal documents about C++ documentation best practices. * '''[DocumentationTools Documentation Tools]'''[[Br]] Projects to improve the docs tool chain, simplifying and integrating it and lowering the barrier for people willing to help us. * '''[ImprovingBoostDocsSubprojects Subprojects]'''[[Br]] There are some small subprojects targeted to solving specific needs. Go to the subprojects page to participate in them. Go to the subprojects page to participate in them. * '''[BrowserTestingChart Browser-testing]'''[[Br]] Volunteers periodically test the new docs on every platform and for every browser. * '''[LibrariesLogos Libraries Logos]'''[[Br]] Go to the logo playground page to find proposed logos for Boost libraries. ---- == People == The people listed below are working on this project or have done work on the tools that this work builds. Some of them may not endorse all the proposals of the project, but all have given their blessing to it. If you are working for this project and do not appear here, please add yourself to the list. If you are listed and want to share your email address and picture here, please add them. [[Br]][[Image(People:no_picture.png,nolink)]] [[Br]]'''Andrew Sutton''' [[Br]][http://www.ohloh.net/projects/3/contributors/37263 Ohloh Statistics] [[Br]]''asutton at cs dot kent dot edu'' [[Br]] [[Br]][[Image(People:cedric_venet.png,nolink)]] [[Br]]'''Cédric Venet''' [[Br]][http://www.linkedin.com/in/cedricvenet Linked In Profile] [[Br]]''cedric dot venet at student dot ecp dot fr'' [[Br]] [[Br]][[Image(People:chris_fairles.png,nolink)]] [[Br]]'''Chris Fairles''' [[Br]]''chris dot fairles at gmail dot com'' [[Br]] [[Br]][[Image(People:chun_ping_wang.png,nolink)]] [[Br]]'''Chun Ping Wang''' [[Br]]''cablepuff at gmail dot com'' [[Br]] [[Br]][[Image(People:no_picture.png,nolink)]] [[Br]]'''Darren Garvey''' [[Br]][http://www.ohloh.net/projects/3/contributors/37269 Ohloh Statistics] [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:dave_abrahams.png,nolink)]] [[Br]]'''Dave Abrahams''' [[Br]][http://www.ohloh.net/projects/3/contributors/94 Ohloh Statistics] [[Br]][http://www.linkedin.com/pub/0/87/22a Linked In Profile] [[Br]]''dave at boost-consulting dot com'' [[Br]] [[Br]][[Image(People:doug_gregor.png,nolink)]] [[Br]]'''Douglas Gregor''' [[Br]][http://www.ohloh.net/projects/3/contributors/101 Ohloh Statistics] [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:eric_niebler.png,nolink)]] [[Br]]'''Eric Niebler''' [[Br]][http://www.ohloh.net/projects/3/contributors/100 Ohloh Statistics] [[Br]][http://www.linkedin.com/pub/0/87/642 Linked In Profile] [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:no_picture.png,nolink)]] [[Br]]'''Filip Konvička''' [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:frank_hess.png,nolink)]] [[Br]]'''Frank Hess''' [[Br]]''fmhess at users dot sourceforge dot net'' [[Br]] [[Br]][[Image(People:glyn_matthews.png,nolink)]] [[Br]]'''Glyn Matthews''' [[Br]][http://www.linkedin.com/pub/4/74/b55 Linked In Profile] [[Br]]''glyn dot matthews at gmail dot com'' [[Br]] [[Br]][[Image(People:jake_voytko.png,nolink)]] [[Br]]'''Jacob Robert Voytko''' [[Br]][http://www.ohloh.net/projects/3/contributors/37270 Ohloh Statistics] [[Br]]''jakevoytko at gmail dot com'' [[Br]] [[Br]][[Image(People:joel_de_guzman.png,nolink)]] [[Br]]'''Joel de Guzman''' [[Br]][http://www.ohloh.net/projects/3/contributors/92 Ohloh Statistics] [[Br]][http://www.linkedin.com/pub/0/89/716 Linked In Profile] [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:john_maddock.png,nolink)]] [[Br]]'''John Maddock''' [[Br]][http://www.ohloh.net/projects/3/contributors/86 Ohloh Statistics] [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:lars_viklund.png,nolink)]] [[Br]]'''Lars Viklund''' [[Br]]''zao at acc dot umu dot se'' [[Br]] [[Br]][[Image(People:matias_capeletto.png,nolink)]] [[Br]]'''Matias Capeletto''' [[Br]][http://www.ohloh.net/accounts/5462/positions/2302 Ohloh Statistics] [[Br]][http://www.linkedin.com/in/matiascapeletto Linked In Profile] [[Br]]''matias dot capeletto at gmail dot com'' [[Br]] [[Br]][[Image(People:paul_bristow.png,nolink)]] [[Br]]'''Paul Bristow''' [[Br]]''pbristow at hetp dot u-net dot com'' [[Br]] [[Br]][[Image(People:no_picture.png,nolink)]] [[Br]]'''Peter Foley''' [[Br]]''boost at ifoley dot id dot au'' [[Br]] [[Br]][[Image(People:rene_rivera.png,nolink)]] [[Br]]'''Rene Rivera''' [[Br]][http://www.ohloh.net/accounts/911/positions/1130 Ohloh Statistics] [[Br]][http://www.linkedin.com/in/rrivera Linked In Profile] [[Br]]''email unknown'' [[Br]] [[Br]][[Image(People:stjepan_rajko.png,nolink)]] [[Br]]'''Stjepan Rajko''' [[Br]][http://www.ohloh.net/projects/3/contributors/36592 Ohloh Statistics] [[Br]]''stjepan dot rajko at gmail dot com'' [[Br]] [[Br]][[Image(People:stuart_dootson.png,nolink)]] [[Br]]'''Stuart Dootson''' [[Br]]''stuart dot dootson at gmail dot com'' ---- == Team Mascot == #team_mascot [[Br]][[Image(mafalda.png,nolink)]] [[Br]]'''Mafalda''' [[Br]]''Team Mascot'' Mafalda is an [http://en.wikipedia.org/wiki/English_Springer_Spaniel English springer spaniel] from Argentina, currently living with Matias. She is helping him with the project wiki page. She just barks once in a while, but that is a lot. ---- == Acknowledgments == [[Image(http://matias.capeletto.googlepages.com/thanks.png,nolink)]] Big thanks to Daniel James, Janek Kozicki, João Abecasis, Matt Doyle and Michael Marcin. You are welcome to became active members of the project, in which case please add yourselves to the list above. Thanks to all the others who have helped us in discussion on the Boost list. ---- * [ImprovingBoostDocs Improving Boost Docs] * '''[ImprovingBoostDocs About this project]''' * [BoostDocsRepository Boost docs repository] * [UnifiedLookAndFeelProject Unified look and feel project] * [HelpingBoostAuthors Helping Boost Authors] * [GlueDocsProject Glue docs project] * [StandardCppLibraryDocumentation Standard C++ Library Docs] * [DocumentationBestPractices Documentation Best Practices] * [DocumentationTools Documentation Tools] * [ImprovingBoostDocsSubprojects Subprojects] * [BrowserTestingChart Browser Testing Chart] * [LibrariesLogos Logo Playground] ----