Previously Héctor Velarde wrote: > Wichert Akkerman wrote: > >schemaextender fully documents its adapters in their interface > >definition. For this case see ISchemaModifier > > well, in fact schemaextender fully documented that on README.txt and I > could had found it, if you hadn't erase it ;-)
Indeed, Martin just mailed me about that as well. I rewrote the README for a reason: as a testsuite it was incomplete and slow, and I found it very hard to understand as documentation if you did not already know exactly what it did and how things worked. A problem with doctests is that you need to insert a lot of extra fluff that is not interesting for human readers but which is needed to run the code as a test. This README suffered a lot from that. I added simple unittests to atse that have a better test coverage and run many many times faster than the old doctest. I also did my best to make the README as simple to understand as possible. I did not go into some of the details such as the schema modifier since those are not going to be important for 99% of the users and the interface definition has a decent description for them. If I had more time to spent on it I would have added those with some short examples to the README as well, but even without that I strongly feel that the new README is an improvement over the old one. Wichert. -- Wichert Akkerman <[EMAIL PROTECTED]> It is simple to make things. http://www.wiggy.net/ It is hard to make things simple. _______________________________________________ Product-Developers mailing list [email protected] http://lists.plone.org/mailman/listinfo/product-developers
