Namespace documents & rddl
--------------------------
Key: MASHUP-700
URL: https://wso2.org/jira/browse/MASHUP-700
Project: WSO2 Mashup Server
Issue Type: Improvement
Reporter: Jonathan Marsh
Assignee: Channa Gunawardena
[Seems like this thread died - recording it here for action.]
Here is an example and the proposed associated directory structure and content
for it:
http://www.wso2.org
/ns
/jstypes (server-side redirect to /jstypes.xhtml)
/jstypes.xhtml
(http://wso2.org/repos/wso2/people/jonathan/jstypes.xhtml)
/jstypes.xsd
(http://wso2.org/repos/wso2/people/jonathan/jstypes.xsd)
/2007-08-01
/jstypes.xsd
(http://wso2.org/repos/wso2/people/jonathan/jstypes.xsd)
I have created a RDDL template as well
(http://wso2.org/repos/wso2/people/jonathan/rddl_template.xhtml) to facilitate
future namespace definitions.
To dos:
1) Arch list: verify that this structure is acceptable, namely:
a) using namespaceURI + ".xsd" as the "latest schema"
location
b) using /ns/yyyy-mm-dd/shortname.xsd as a dated schema
location this has the advantages that:
i) filename doesn't change between locations (e.g.
always jstype.xsd)
ii) allows dated versions to change on a daily basis
for quick evolution
iii) doesn't generate a deep and complex tree
2) OT: Add OT logo, any generic links and styling to jstypes.xhtml and
the rddl_template.xhtml.
3) OT: Find a home for rddl_template.xhtml (perhaps
/ns/rddl_template.xhtml is sufficient.)
4) OT: Make /ns browseable (directory listing) so we have an
authorative source for listing all the namespaces we've defined.
Jonathan Marsh - http://www.wso2.com - http://auburnmarshes.spaces.live.com
> -----Original Message-----
> From: [EMAIL PROTECTED] [mailto:architecture-
> [EMAIL PROTECTED] On Behalf Of Sanjiva Weerawarana
> Sent: Friday, July 27, 2007 7:29 PM
> To: [EMAIL PROTECTED]
> Subject: Re: [Architecture] Directory for WSO2 namespaces
>
> +1 .. can u please give them a single RDDL file to start this with?
> Chatra, we need a general page on /ns to say this is our namespaces
> page and what the users can expect to find (a RDDL doc).
>
> Sanjiva.
>
> Jonathan Marsh wrote:
> > I like that one too, I'll use it for the Javascript types pending
> approval
> > by the OT team.
> >
> > Jonathan Marsh - http://www.wso2.com -
> http://auburnmarshes.spaces.live.com
> >
> >
> >> -----Original Message-----
> >> From: [EMAIL PROTECTED] [mailto:architecture-
> >> [EMAIL PROTECTED] On Behalf Of Keith Chapman
> >> Sent: Friday, July 27, 2007 9:45 AM
> >> To: [EMAIL PROTECTED]
> >> Subject: Re: [Architecture] Directory for WSO2 namespaces
> >>
> >> +1 for using w3c like namespaces. http://www.wso2.org/ns/... is
> >> +more
> >> like it.
> >>
> >> Thanks,
> >> Keith.
> >>
> >> Jonathan Marsh wrote:
> >>> We see a need to assign some XML namespaces to the WSO2 domain -
> e.g.
> >>> the Mashup Server needs to define a namespace representing a WSO2
> >>> convention for wrapping Javascript types in XML:
> >>>
> >>> <jsSimpleType type="string"
> >>> xmlns="http://www.wso2.org/ns/javascript";>foobar</jsSimpleType>
> >>>
> >>> We will undoubtedly need other namespaces at some point in the
> >> future.
> >>> I'd like to define a mechanism that we can manage these namespaces
> >>> now. Considerations:
> >>>
> >>> 1) Should have a RDDL document at the namespace Url - so these
> >>> Urls should be reserved and managed by our webmasters.
> >>>
> >>> 2) I think wso2.org is the right home, rather than wso2.com, since
> >> all
> >>> the foreseen namespaces would be related to wso2.org projects.
> >>>
> >>> 3) Namespace urls that are short and memorable are best.
> >>>
> >>> 4) Once assigned, a namespace should only evolve in
> >>> backwards-compatible ways. Using dated paths
> (ns/2007/07/javascript)
> >>> helps when a namespace is still under development.
> >>>
> >>> Some base URIs we could consider:
> >>>
> >>> - http://www.wso2.org/ns/...
> >>>
> >>> - http://namespaces.wso2.org/...
> >>>
> >>> - http://ns.wso2.org/...
> >>>
> >>> - http://wso2.org/ns/ .
> >>>
> >>> - http://wso2.org/namespace/...
> >>>
> >>> - ?
> >>>
> >>> Thoughts?
> >>>
> >>> *Jonathan Marsh* - http://www.wso2.com -
> >>> http://auburnmarshes.spaces.live.com
> >>>
> >>> ------------------------------------------------------------------
> >>> -
> --
> >> ---
> >>> _______________________________________________
> >>> Oxygentank mailing list
> >>> [EMAIL PROTECTED]
> >>> https://www-lk.wso2.com/cgi-bin/mailman/listinfo/oxygentank
> >>>
> >>
> >> _______________________________________________
> >> Architecture mailing list
> >> [EMAIL PROTECTED]
> >> https://www-lk.wso2.com/cgi-bin/mailman/listinfo/architecture
> >
> >
> > _______________________________________________
> > Architecture mailing list
> > [EMAIL PROTECTED]
> > https://www-lk.wso2.com/cgi-bin/mailman/listinfo/architecture
> >
>
> --
> Sanjiva Weerawarana, Ph.D.
> Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
> email: [EMAIL PROTECTED]; cell: +94 77 787 6880; fax: +1 509 691 2000
>
> "Oxygenating the Web Service Platform."
>
> _______________________________________________
> Architecture mailing list
> [EMAIL PROTECTED]
> https://www-lk.wso2.com/cgi-bin/mailman/listinfo/architecture
_______________________________________________
Architecture mailing list
[EMAIL PROTECTED]
https://www-lk.wso2.com/cgi-bin/mailman/listinfo/architecture
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
https://wso2.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
_______________________________________________
Mashup-dev mailing list
[email protected]
http://www.wso2.org/cgi-bin/mailman/listinfo/mashup-dev
