Sunday, September 16, 2007

dcov 0.2.1 Released!

I just pushed a new version of dcov, the Ruby documentation analyzer, to the Rubyforge servers. This version adds a new analyzer setup and quality analysis. The new analyzers go from crazy scripts that pick through the guts of dcov and do a lot of stuff to slightly abstracted but much prettier scripts that use a nice DSL. For example, this is from the quality analyzer:

documentation_for_methods do |the_documentation|
the_documentation.must "document all parameters." do
param_names_for(the_documentation.token).each do |param|
the_documentation.token.reporting_data[:parameters_without_coverage] << param[0] unless the_documentation.token.comment.include?("+#{param[0]}+")
end if the_documentation.token.params

If you can't tell, I based the aesthetics of the analyzers on RSpec specs. They are nicer, but they should probably reveal less of the guts of dcov.

The basic analyzers that come with it work, but they're really supposed to be examples for you to work from (hence the nicer syntax for analyzers). Everyone has different documentation standards (placement of elements and units to be documented) with varying degrees of analness (some people aren't allowed to you direct address, for example). The included analyzers can give you a very basic idea of how your documentation is doing, but I'd like to see people develop new quality analyzers...possibly contributing back? :)

Enjoy and please e-mail me, IM me, or comment with any bug reports or problems. Or you can use that silly bug tracker thing.


DaleFlannery said...
This comment has been removed by the author.
Ramona B. Suttle said...

This type of analyses is very important and you have to examine every part of ruby. I know it is not an easy task but with the help of this application, you make it possible to examine everything but assignment writing service is the best option to manage all type of task. This is wonderful knowledge about analyses of ruby.

Sophie Grace said...

thanks for share amazing article Nonton Drama Korea

Emily said...

thanks for post
FaceTime for PC Windows 10

Salma889 said...

Safeguarding the personal details of our customers is what we cherish. In this case, we ensure that your information is kept safe in our databases, which cannot be accessed by anyone For this reason, it guarantees you getting solutions for different types of literature review since no one will know whether you asked for assistance from a professional service.

narikolabby said...

Slotomania has a huge number 강원랜드 쪽박걸 of free slot video games that you simply can} spin and enjoy! Whether you’re looking for traditional slots or video slots, they're all free to play. You can play on-line slots free of charge on the web sites we listed above, supplying you with full access to five,000+ different machines with hyper-realistic animations and various themes. If you decide to maneuver previous the free versions of actual cash slots, you’ll claim a huge welcome package.