Asger, +1 on getting the documentation in shape... it obviously needs it if we can't recall (even by looking at the docs) that the function to create an object w/o posting content exists.
While working on FCREPO-556 (sdef method invocation), it really hit home for me that the REST api docs are written in an RPC style. It was useful to have the comparison with the original API-A/M methods, but I think if the docs were written in a resource-oriented way it would make more sense. - Chris On Tue, Nov 24, 2009 at 4:19 AM, Asger Askov Blekinge <[email protected]> wrote: > Hi > > I just reported a bug for Fedora: > http://fedora-commons.org/jira/browse/FCREPO-585 > > I was working on implementing > https://fedora-commons.org/jira/browse/FCREPO-579 ie adding a api method > for creating a new object. I have added this to the soap and Fedora > client code. When adding it to the REST api, I became surprised. > > The REST api already had that code. If you perform > POST: /objects/new without content, a new empty object will be created, > with an autogenerated pid. > > I was both happy and angry to see that. Angry because we have had LONG > discussions on both the committers meetings and on this list about the > REST api. I proposed a REST method for creating new objects, along the > lines of the one above. People commented, but nobody said that we > already had that function. > > I feel that we cannot stabilize the REST api with the current > documentation. I think there might be other gotcha's inthere, and that > we need to review the REST code before the 3.3 release. Note, I do not > think the code is wrong, or bad. I even think the javadocs might be > good, but the online documentation does not properly reflect the api. > > Regards > > > > > ------------------------------------------------------------------------------ > Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day > trial. Simplify your report design, integration and deployment - and focus on > what you do best, core application coding. Discover what's new with > Crystal Reports now. http://p.sf.net/sfu/bobj-july > _______________________________________________ > Fedora-commons-developers mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/fedora-commons-developers > ------------------------------------------------------------------------------ Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day trial. Simplify your report design, integration and deployment - and focus on what you do best, core application coding. Discover what's new with Crystal Reports now. http://p.sf.net/sfu/bobj-july _______________________________________________ Fedora-commons-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/fedora-commons-developers
