Ben,
Agreed.
jrs
On Oct 22, 2007, at 2:11 PM, Benjamin Shine wrote:
The mission statement for ringding is to reproduce the old docs
with the new toolchain. I suggest that we delay information design
work until we're really ready to engage information design work
*coherently*.
I propose that the doc stakeholders and toolsmith(s) get together
in December to an *offsite location* and argue about/specify docs
for a day.
-ben
On Oct 22, 2007, at 7:56 AM, John Sundman wrote:
Ben,
Yes, this is the gold ore I'm talking about.
It needs to be processed into bullion, I think, to get its full
value.
In other words, there is all kinds of cool info in this raw index,
but it's all at the same level and thus not very helpful. It
really needs some information-design work to be truly useful. IT
would be very cool if we could work on that before we ship RingDing.
jrs
I must correct myself -- we do generate a comprehensive
alphabetical index, of the kind one would expect to find at the
end of a paper book, under the title "Index." That comprehensive
alphabetcial index is in the file doc/indexapa.html and it
contains links to content in the developer's guide and the
reference guide.
You can see this comprehensive index in the paperpie nightly build:
http://labs.openlaszlo.org/paperpie-nightly/docs/indexapa.html
(although, by the time you see this, a new build will have
deployed, which might break the above link.)
-ben
