Return to the Press page

Vyatta – Linux & Open Source Alternative to Cisco – Advanced Routing, Firewall, VPN, QoS..
Free Download ->

LWN.net Weekly Edition for October 2, 2008

openSUSE and the distribution of proprietary software

Weekly edition	Kernel	Security	Distributions	Search
Archives	Calendar	Subscribe	Write for LWN	LWN.net FAQ

Unit Testing Your Documentation (O'ReillyNet)

[Posted September 8, 2006 by ris]

Leonard Richardson writes about testing the recipes in the Ruby Cookbook. "Thanks to the test framework, on a good day I could proofread, debug, and verify the correctness of 30 recipes. I worked faster and with greater confidence than I could doing everything by hand. I was also able to incorporate the test results into the general "confidence score" calculated for each recipe on my unofficial Ruby Cookbook homepage: a visible, though somewhat vague, metric of quality."

(Log in to post comments)

Zope 3

Posted Sep 11, 2006 16:36 UTC (Mon) by faassen (subscriber, #1676) [Link]

Zope 3 is a Python-based web framework that has been using doctests (the Python version of this which inspired the author) for a long time now. Most new tests are written as doctests, and we're even able to test browser interaction (and thus integration tests) in a doctest format.

Zope 3 has been developed using a test-heavy strategy from the start. We find doctests help improve the quality and maintainability of our tests. It also tremendously improves the quality and quantity of developer documentation.