Good idea. Though if we put this as part of the generated site, it won't be on http://oozie.apache.org/docs/ until our next release, right? Perhaps we should have a url off the main site (e.g. http://oozie.apache.org/schemas/) and just put the schemas in there for now; once we have the next release, we can have the url forward to the generated /docs/ location. This would allow us to make the schemas available now and also have a permanent "latest" link to the schemas so it doesn't keep changing (from the user's perspective) with every release (under the /docs/ location, it would be /docs/3.3.0/whatever, then /docs/3.3.1/whatever, etc).
- Robert On Thu, Dec 6, 2012 at 12:59 PM, Jun Aoki <[email protected]> wrote: > Done > > https://issues.apache.org/jira/browse/OOZIE-1120 > > > - jun > > > On Thu, Dec 6, 2012 at 12:05 PM, Mohammad Islam <[email protected]> > wrote: > > Good proposal. > > > > --Mohammad > > > > > > > > > > ________________________________ > > From: Alejandro Abdelnur <[email protected]> > > To: [email protected] > > Sent: Thursday, December 6, 2012 12:02 PM > > Subject: Re: Publish schemas on the web site ? > > > > Sounds good, we should added to the generated site. We'll need to play > > with the assembly that generates the docs. > > > > Clément or Jun Aoki, would you mind filing a JIRA for this? And of > > course, working on it would be welcome :) > > > > Cheers > > > > On Thu, Dec 6, 2012 at 11:11 AM, jun aoki <[email protected]> > wrote: > >> Forgot to mention one liner. In my previous email, <start> <action> > >> <map-reduce> <end> and all other elements defined in the xsd can be > >> suggested and autocompleted by the XML editors. It is very productive > for > >> users. > >> > >> > >> On Thu, Dec 6, 2012 at 11:06 AM, jun aoki <[email protected]> > wrote: > >> > >>> Alejandro, > >>> > >>> It will be good if the schema files are accessible from a real xml > file, > >>> but not in a part of web page. > >>> For example > >>> > http://svn.apache.org/viewvc/oozie/trunk/client/src/main/resources/oozie-workflow-0.4.xsd?revision=1382193&view=co > >>> is exactly what Clement needs, but the URL is not ideal because it has > a > >>> revision number and it should not be in a Subversion. > >>> Instead, it will be great if we could publish it shorter and more > permanent > >>> link type like > >>> http://oozie.apache.org/schemas/3.1.3/oozie-workflow-0.4.xsd > >>> > >>> What users benefit from it is they can open any XML editor (e.g. > Eclipse, > >>> XMLSpy) and start with schemaLocation, then the editors will > autocomplete > >>> and suggests possible elements and attributes. > >>> > >>> Clement, if it is what you want I can make a ticket and will see what I > >>> can do. > >>> > >>> <?xml version="1.0" encoding="UTF-8"?> > >>> <workflow-app xmlns="uri:oozie:workflow:0.4" > >>> xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; > >>> xsi:schemaLocation="uri:oozie:workflow:0.4 > >>> http://oozie.apache.org/schemas/3.1.3/oozie-workflow-0.4.xsd"; > >>> name="flow1"> > >>> > >>> <start to="next1"/> > >>> <action name="action1"> > >>> <map-reduce></map-reduce> > >>> <ok to="ok1"/> > >>> <error to="error1"/> > >>> </action> > >>> > >>> <end name="end1"/> > >>> </workflow-app> > >>> > >>> > >>> > >>> On Thu, Dec 6, 2012 at 10:41 AM, Clément MATHIEU < > [email protected]>wrote: > >>> > >>>> On 2012-12-06 18:16, Alejandro Abdelnur wrote: > >>>> > >>>> Hi Alejandro, > >>>> > >>>> > >>>> They are avail in the Oozie docs: > >>>>> > >>>> > >>>> My goal is to use the schemas for validation purpose not > documentation. > >>>> By specifying the schema(s) location(s) in the document, or in a > catalog, > >>>> you allow the editor to validate the document on the fly and to > provide > >>>> auto-completion and documentation. > >>>> > >>>> If the schemas are not officially published, users have to deploy the > >>>> schemas by themselves (or use the svn/github web interfaces when > possible). > >>>> > >>>> Am I the only one to find this feature valuable ? > >>>> > >>>> - Clément > >>>> > >>> > >>> >
