Zeljko and other Rdoc enthusiasts! I like how rspec guys keep their rdocs http://rspec.rubyforge.org/rspec/ they version it and the latest is here http://rspec.rubyforge.org/rspec/1.3.0/
I suggest we do the same for http://wtr.rubyforge.org/rdoc - move the current rdoc/* to rdoc/1.6.2/ - generate new rdoc for 1.6.5 and publish it to rdoc/1.6.5 - from watir.com keep the link to http://wtr.rubyforge.org/rodc as it is there I am still on hold for yardoc issues for yardoc.org and rdoc.info but rdoc can be published and republished as we make updates I spoke with Bret, he's going go give me rubyforge access but first I wanted to ask you guys what you think of this plan and if you like the rdoc currently generated by hanna template. (yes, you can search for methods) http://rubytester.com/test/watir/rdoc/ marekj Watirloo: Semantic Page Objects in UseCases http://github.com/marekj/watirloo/ Support Watir Project http://pledgie.com/campaigns/2982 On Mon, Jan 11, 2010 at 10:50 PM, marekj <[email protected]> wrote: > I setup issues log just for rdoc generation (includes yardoc) > http://github.com/marekj/watir/issues > > I got yardoc running fine at the top watir level and at watir/watir as > an rake task > However the rdoc.info is not generating the yardoc. > I ask for support here: > http://github.com/zapnap/rdocinfo/issues/#issue/34 > > Please look throught the yardoc and rdoc and let me know if I should > add or remove classes > next will be to clean up rdoc markup that yardoc has trouble with. > (fyi, the docs now include the commonwatir files) > > marekj > > Watirloo: Semantic Page Objects in UseCases > http://github.com/marekj/watirloo/ > Support Watir Project http://pledgie.com/campaigns/2982 > > > > On Sun, Jan 10, 2010 at 12:13 PM, marekj <[email protected]> wrote: >> FYI >> http://rubytester.com/test/watir/yardoc/ >> first pass at yardoc to match the rdoc >> http://rubytester.com/test/watir/rdoc/ >> >> I need to look at yardoc cli options and YARD::Rake::YardocTask >> >> marekj >> >> Watirloo: Semantic Page Objects in UseCases >> http://github.com/marekj/watirloo/ >> >> >> >> >> On Sun, Jan 10, 2010 at 3:50 AM, marekj <[email protected]> wrote: >>> Hi, >>> I think this is going to be a long thread. >>> So I've made some changes >>> They are visitble in rodc here >>> http://rubytester.com/test/watir/rdoc/ >>> >>> changes so far >>> - I pullled license.rb, readme.rb, changes.rb out from lib and set up >>> the corresponding .rdoc files >>> - switched CHANGES to HISTORY.rdoc and moved the latest 1.6.5 notes >>> from NEWCHANGES >>> - left NEWCHANGES as a placehold for notes on the moving forward place >>> (I assume this is what it's for) >>> - I like hanna rdoc template and I'm stickng with it so I make rake >>> rdoc use hanna/rdoctask if you have it. >>> if you don't you will have a regular old rdoc do do gem install hanna >>> - added commonwatir/lib/**/*.rb to main watir rdoc (only for dev not >>> gemspec) >>> >>> >>> some plan >>> - switch to jeweler/gemcutter >>> the rake task deal with pushing to github and gemcutter and we can >>> generate gemspec easier >>> - make unittests run after installing the gem >>> this has been on my personal plate for a while >>> - copy some verbage from Watir::Browser in commonwatir to README.rdoc >>> - probably remove the unittest from gemspec package. they can't be >>> used anyway. (maybe move all unittests to commonwatir gem so people >>> can run them after gem install?) >>> >>> marekj >>> >>> Watirloo: Semantic Page Objects in UseCases >>> http://github.com/marekj/watirloo/ >>> >>> >>> >>> >>> On Sat, Jan 9, 2010 at 11:29 PM, Alan Baird <[email protected]> wrote: >>>> +1 for including commonwatir in the rdocs (or at least accessible from >>>> them). I never can seem to remember the syntax for >>>> Watir::Waiter.wait_until, which I use occasionally enough for it to be >>>> annoying not to be in the normal places. >>>> Alan >>>> _______________________________________________ >>>> Wtr-development mailing list >>>> [email protected] >>>> http://rubyforge.org/mailman/listinfo/wtr-development >>>> >>> >> > _______________________________________________ Wtr-development mailing list [email protected] http://rubyforge.org/mailman/listinfo/wtr-development
