[prev in list] [next in list] [prev in thread] [next in thread] 

List:       subversion-issues
Subject:    =?UTF-8?B?W0lzc3VlIDMxMjldIE5ldyAtIFJldmlldyBuZXcgMS41IEFQSXM=?=
From:       cmpilato () tigris ! org
Date:       2008-03-19 19:49:46
Message-ID: iz3129 () subversion ! tigris ! org
[Download RAW message or body]

http://subversion.tigris.org/issues/show_bug.cgi?id=3129
                 Issue #|3129
                 Summary|Review new 1.5 APIs
               Component|subversion
                 Version|1.5.x
                Platform|All
                     URL|
              OS/Version|All
                  Status|NEW
       Status whiteboard|
                Keywords|
              Resolution|
              Issue type|TASK
                Priority|P2
            Subcomponent|src
             Assigned to|issues@subversion
             Reported by|cmpilato






------- Additional comments from cmpilato@tigris.org Wed Mar 19 12:49:46 -0700 2008 -------
Julian Foad writes:

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.

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@subversion.tigris.org
For additional commands, e-mail: issues-help@subversion.tigris.org

[prev in list] [next in list] [prev in thread] [next in thread]