Your docs certainly have improved since the last time I looked (a coupla 
years ago).

As to why I think it would be good... well I kinda sit outside all three of 
the CFML sub-communities (ie: CF, Railo, OpenBD), and I really don't see 
that the compartmentalisation as being a good thing: it divides what is 
already a small and fractured community-base.  At the end of the day we all 
use CFML, and I think most people don't give a rat's arse which flavour 
(that said, I imagine *most* people who use CFML don't even know of Railo 
or OpenBD's existence, so probably don't know there's alternatives).  I do 
need to do a small amount of work on all three platforms, and it's a right 
PitA to have to deal with the idiosyncrasies that all three have, so having 
a unified place to look would be handy.

I guess it comes down to demographics: do most users use one or another of 
the platforms, or do most users use two or more simultaneously, or what.  I 
can't actually answer that.  I would have thought most people would use a 
mix?  If people tend to use one platform and only one platform (whichever 
that is), then there *would* be less point in having unified docs.  That 
said, having all the doc effort going into one place would mean the end 
result would be better than the sum of the parts.  Which would be a good 
thing for all three communities.  That's kinda where I was coming from.

Anyway, if you don't see the point: fair enough.

-- 
Adam



On Friday, September 14, 2012 1:09:26 PM UTC+1, Alan Williamson wrote:
>
>  It is a noble effort for sure, and i wish you all the luck with it.  Not 
> sure why we need such a thing.  Engines are different.  Documentation will be 
> different.  Different is good.
>
> We will endeavor to keep our own docs as up to date as possible, and since 
> our docs ship with every distribution and nightly build you are free of 
> course to suck those into any given central repository.
>
>
> On 14/09/2012 05:49, Adam Cameron wrote:
>  
> *The bottom line is I'd be dead keen to get a common CFML documentation 
> project going, and did a small amount of research into it a while back.*
>
>
>  

-- 
online documentation: http://openbd.org/manual/
 http://groups.google.com/group/openbd?hl=en

Reply via email to