API review for v1.5

As part of checking that we're ready for a v1.5 release, I think we should
review all the new and revised APIs.

I hope that each person who is prepared to do some of this will look at some
APIs that they haven't been working on, and:

   - check the doc strings are understandable (understandable enough to someone
not intimately familiar with the feature) and accurate;

   - check the APIs provide functionality that will be maintainable in future
(for example, better to be restrictive rather than overly permissive at first,
and not mixing up layers of knowledge);

   - where revising an old API, check the "deprecated" and "new" tags and the
new name and the way in which the old API forwards parameters to the new one;

Can anyone volunteer for a sub-set of this? Choose one library, or choose a
major feature and look for all of its APIs.

Thanks,
- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe_at_subversion.tigris.org
For additional commands, e-mail: dev-help_at_subversion.tigris.org
Received on 2008-03-07 15:28:51 CET