Hi +1
That's good news. I'm interested. In the medium/long term we'll have more javascript stuff in myfaces projects that needs to be documented, and this could be a very valuable contribution. regards, Leonardo 2011/3/11 Scott O'Bryan <[email protected]> > So I did do some checking on this and we have something we are using > in-house here at Oracle. It uses a more robust javascript parser to > generate the Javadocs and even allows the code to be annotated to produce > much cleaner documentation. The only bad thing about it is that we have > some parsing for inheritance that is probably specific to our richclient. > > I talked with the guy who wrote and and he'd be willing to donate it if > people are interested. He said ripping out the proprietary stuff for > inheritance should be pretty easy and then the MyFaces community could > enhance to to allow the docs to work on our own stuff. Are people > interested? > > If so, I can open up a discussion on the dev list with the specifics. > > Scott > > > On 03/10/2011 10:59 AM, Scott O'Bryan wrote: > >> Very good points Leonardo, and your right about Trinidad's parser. I >> do know that I've seen some stuff in-house which generates >> javascriptDoc and even does auditing. Let me check to see if it's >> something we can donate or if it's too specific to our legacy code.. >> >> On Mar 10, 2011, at 10:35 AM, Leonardo Uribe<[email protected]> wrote: >> >> Hi >>> >>> I think one of the problems right now it is necessary to overcome is >>> create >>> a javascript documentation maven plugin for trinidad, myfaces core 2.0.x, >>> and probably tobago. >>> >>> If you take a look at the sites of those projects, you'll see there is >>> generated javadoc, tlddoc, facelets-tlddoc and other documentation >>> reports >>> available on the site. But there is not anything for javascript. >>> >>> The reason is there is not a maven plugin written in java that do the >>> job. >>> In theory it is possible to use jsdoc toolkit, but unfortunately there is >>> some code on myfaces core that by its structure can't be documented >>> properly >>> with that tool (I already tried it, it just don't), and mozilla rhino >>> causes >>> some problems when the goal is executed, because it loads the javascript >>> file too. >>> >>> This is a good idea for a Google Summer Of Code, because in practice half >>> of >>> the solution is done. Trinidad javascript plugin contains a code that is >>> capable of parse javascript files (look the obfuscator), so what we need >>> is >>> use this code and create some code that scan for doclets (annotations on >>> the >>> comments), get the information and build a model and finally generate the >>> documentation using a template tool like velocity. Again we have already >>> some code on myfaces builder plugin that could be useful. >>> >>> Trinidad code is very robust. With JSF 2.0, we have a common ajax >>> framework, >>> so in theory it is possible to create custom ajaxified components and >>> make >>> them work together with trinidad. But I think what users wants is to know >>> the details behind it and how they can extend or override trinidad stuff. >>> >>> regards, >>> >>> Leonardo Uribe >>> >>> 2011/3/10 Scott O'Bryan<[email protected]> >>> >>> Walter, >>>> >>>> Yeah, while creating a new renderkit isn't trivial, the Trinidad >>>> internals and API really lend themselves to allowing extensions to the >>>> framework. >>>> >>>> I know Oracle, for instance, has a very large renderkit extension >>>> which is based on Trinidad Internals. Now it's mostly geared toward >>>> support of web business applications, but it really shows what can be >>>> done with the framework. >>>> >>>> I really would like to see a project like this get some traction >>>> personally. ;) >>>> >>>> Scott >>>> >>>> On Mar 6, 2011, at 5:39 AM, Walter Mourão<[email protected]> >>>> wrote: >>>> >>>> Thank you Dominik. >>>>> >>>>> Just to be clear: the aim is not simply compete... >>>>> I think Trinidad has: >>>>> - rock solid back-end; >>>>> - support to non-javascript browser (I have applications running in old >>>>> >>>> data >>>> >>>>> collectors - windows mobile) >>>>> ... >>>>> and I would like to keep most of the java code untouched when migrating >>>>> >>>> my >>>> >>>>> applications to an "up to date UI". >>>>> >>>>> I am personally highly involved in another open source project and I >>>>> >>>> don't >>>> >>>>> have much experience with JSF/Trinidad internals. I am not sure I can >>>>> >>>> help >>>> >>>>> much in such a task (create the new render kit), but I'm experimenting >>>>> to >>>>> see if I should go ahead with Trinidad or just migrate to another >>>>> >>>> library. >>>> >>>>> Best regards, >>>>> >>>>> Walter Mourão >>>>> http://waltermourao.com.br >>>>> http://arcadian.com.br >>>>> http://oriens.com.br >>>>> >>>>> >>>>> >>>>> 2011/3/6 Dominik Dorn<[email protected]> >>>>> >>>>> If you're really want to compete with PrettyFaces, IceFaces, RichFaces >>>>>> etc., >>>>>> I suggest to take a look at >>>>>> >>>>>> http://demo.sproutcore.com/sample_controls/ >>>>>> http://www.sproutcore.com >>>>>> >>>>>> and rebuilt those for JSF. >>>>>> Sproutcore is currently quite hyped in twitter and gains a lot of >>>>>> interest, especially >>>>>> in the rails community. >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> 2011/3/6 Walter Mourão<[email protected]>: >>>>>> >>>>>>> Hi folks, >>>>>>> following the thread "Concerns about the future of Trinidad" I would >>>>>>> >>>>>> like >>>> >>>>> to >>>>>> >>>>>>> know the opinions about the "best' Javascript package to use as a >>>>>>> base >>>>>>> >>>>>> to >>>> >>>>> a >>>>>> >>>>>>> new Trinidad render kit. >>>>>>> >>>>>>> JQuery<http://jquery.org/> >>>>>>> >>>>>>> Dojo Toolkit<http://dojotoolkit.org/> >>>>>>> >>>>>>> (another options ?) >>>>>>> >>>>>>> What do you think ? what about the licensing ? >>>>>>> >>>>>>> Thanks, >>>>>>> >>>>>>> Walter Mourão >>>>>>> http://waltermourao.com.br >>>>>>> http://arcadian.com.br >>>>>>> http://oriens.com.br >>>>>>> >>>>>>> >>>>>> >>>>>> -- >>>>>> Dominik Dorn >>>>>> http://dominikdorn.com >>>>>> http://twitter.com/domdorn >>>>>> >>>>>> Tausche Deine Lernunterlagen auf http://wu.studyguru.eu ! >>>>>> >>>>>> >
