[ANN] Rote 0.3.0 (doc/web)

[Ross Bamford]

Hi,

Rote 0.3.0 is now available for download from http://rote.rubyforge.org/.
This is a big step for Rote, and incorporates many new features along with
many improvements and fixes to existing functionality.

New features such as page filters, Ruby syntax highlighting (surprise
surprise and integration with HTML Tidy, along with more flexible
configuration when the defaults won't do and improved resource / page
dependency handling make this version of Rote a more capable package than
ever before.

Rote is a Ruby-based templating / documentation builder based on Rake that
lets you fully integrate your documentation build with your Rake tasks,
and supports ERB rendering, plaintext formatting, arbitrary filtering, and
layout. Although very flexible, Rote favours convention and has no
'configuration' beyond the Rake task definition and Ruby code applied to
pages.

This upgrade introduces some incompatibilities with Rote 0.2.x builds
(only small changes needed).

Please note a small error has been found in the template project
distributed with Rote. After creating a project you will need to remove
the 'format_opts << ...' line from doc/pages/index.rb. That'll teach me to
make releases late at night...

Cheers,
Ross

 

[Ross Bamford]

(Straight to the fix:
http://rubyforge.org/frs/?group_id=1120&release_id=3802 )

Please note a small error has been found in the template project
distributed with Rote...

How innocuous it seemed at first

===[CUT]===

In response to a number of late-breaking issues with the recent Rote 0.3.0
release, a maintainence release is now available from Rubyforge FRS and
Gems, numbered version 0.3.0.2. This release fixes the following critical
issues with 0.3.0:

* Template project / builtin rakefile inoperable
* Common code inhertance malfunction
* Base macro filter was an old version
* Formatting unit test was an old version

These issues were at the root of many problems with 0.3.0, which may have
been masked if you migrated with a custom Rakefile. This mistake was
allowed to happen due to a build-machine misconfiguration which caused a
prior development version of Rote to be tested and packaged. I'd like to
apologise for any inconvenience this may cause.

All Rote 0.3.0 users should upgrade, even if their installation has not
exhibited the aforementioned issues.

===[CUT]===

So, anyone who did download 0.3.0 and found it broken, I'm sorry for that.
I hope you'll give it another chance

One more (quick) thing - I want to put out a direct plea for some
feedback. I've had some great contributions with Rote and we've put a lot
in, but we're at the point now where we could go several ways. Rather than
just randomly picking features () to put on the todo list, I'd really
love to hear some feedback on what people want from a Rake-based software
doc system. I have set up a user mailing list now at
(e-mail address removed).

Cheers,
Ross