[OS3 Proposal] Drop Core Data Spec Document

[James Snell]

The Core Data document
[http://opensocial-resources.googlecode.com/svn/spec/trunk/Core-Data.xml]
is overly complicated and can easily (and more effectively) be
integrated into the other documents as necessary. The document itself,
as it currently stands, provides extremely little value to
implementors. For the sake of simplicity, let's drop it and focus on
doing a better job of discussing the important bits in the other
documents.

[Mark W.]

I don't necessarily disagree with this. I'd like to think of taking another pass a reorganizing the specs in general so they are all much easier to understand. 

I've started a doc here: http://docs.opensocial.org/display/OSD/Simplification+and+Clarification+of+entire+spec

What do you think?

[James Snell]

The categories look fine, but I would prefer to see more effort in the direction of making the fundamental technical specification less complicated, more well defined, with fewer must implement optional items. After that, we can worry about presentation of the use cases. Right now its extremely difficult for a developer not already intimately familiar with the spec to step in and implement even the most basic technical details.

--
You received this message because you are subscribed to the Google Groups "OpenSocial and Gadgets Specification Discussion" group.
To view this discussion on the web visit https://groups.google.com/d/msg/opensocial-and-gadgets-spec/-/rUKnwM_B_uUJ.
To post to this group, send email to opensocial-an...@googlegroups.com.
To unsubscribe from this group, send email to opensocial-and-gadg...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/opensocial-and-gadgets-spec?hl=en.

[Mark W.]

No argument from me.