in reply to RFC hierarchic modelling documentation

This seems quite clear to me, though perhaps a bit abstract. My primary suggestion would be to include some kind of basic example data structure ('Fruit' -> 'Apple' -> 'Granny Smith') with a few notions of how someone might use your module to build an application. I think I understand what the module is for, but I cannot quite see how or for what I would be able to use it.

I thought that the spreadsheet comparison is a bit too simple because it does not involve any kind of tree structure (afaics, but maybe I'm just not a spreadsheet expert). Your target audience obviously will be savy enough to understand the distinction between rulesets and data.

But overall, the writing seems quite clear to me.


sub sk{ return unless $in = shift; $in =~ s!(.)$!!; print $1; sk($in)} sk("gro.alubaf@yehaf");

Replies are listed 'Best First'.
Re^2: RFC hierarchic modelling documentation
by BerntB (Deacon) on Oct 23, 2005 at 19:10 UTC
    This seems quite clear to me, though perhaps a bit abstract.
    Thanks!

    Clear! Clear!! My pain is over!!No more documentation for a while!

    I'll do examples for the CPAN release.

    I thought that the spreadsheet comparison is a bit too simple because it does not involve any kind of tree structure
    Not a spreadsheet comparision, but spreadsheet + XML. Both structure and calculations in one package.

    Thanks for the help, both you, dragonchild, Arunbear and the people helping before! I need help when it comes to documentation.