Did I respond to this? I'd vote for option2 to make a page, something like http://oozie.apache.org/XsdSchemaList.html and which has links to point http://oozie.apache.org/schemas/*.xsd which has the latest xsd files, we can manually copy the latest for now.
Regardless of option 1 or 2, I would like to see the xsd files in the following locations. http://oozie.apache.org/schemas/*.xsd (which has always the latest only) http://oozie.apache.org/schemas/{version nubmer}/*.xsd (they are generated as we release new versions.) e.g. http://www.w3.org/2002/08/xhtml/xhtml1-strict.xsd is the xsd of xhtml. and I kinda want to omit "doc" folder. I made a patch for review https://reviews.apache.org/r/8431/ Please let me know your feedback. On Thu, Dec 6, 2012 at 2:57 PM, Alejandro Abdelnur <[email protected]> wrote: > Makes sense > > * option 1: create a wiki with a table with all the schemas for > everything all versions and attach them there > * option 2: create an APT page with the same and republish the site > > option 1 is simpler and the effect would be the same, just the URL of > the XSD would be a bit ugly. > > Thoughts? > > On Thu, Dec 6, 2012 at 2:09 PM, Robert Kanter <[email protected]> > wrote: > > 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 > >> >>>> > >> >>> > >> >>> > >> >
