[Zope3-dev] copied doctest in z3.zope3recipes for Windows support

[Wichert Akkerman]

Previously Martijn Faassen wrote:
> Hi there,
> 
> I don't have any Windows knowledge, so my ability to review Roger's 
> changes to add (much needed!) windows support to z3.zope3recipes is 
> limited.
> 
> I do however notice that an entire doctest was more or less copied 
> verbatim: README.txt got copied to WINDOWS.txt. The Windows version has 
> some changes, and a few additions, but it's almost exactly the same.
> 
> Now if these were unit tests this would be less problematic, but this is 
> a document as well, and as a result we now have two virtually identical 
> documents to maintain. That seems wrong.

I don't understand that. Having to maintain duplicate unit tests or
duplicate documents sounds like the exact same amount of duplicate work
and problems to me. Why do you consider duplicate documents to be more
problematic?

Wichert.

-- 
Wichert Akkerman <wichert at wiggy.net>    It is simple to make things.
http://www.wiggy.net/                   It is hard to make things simple.