[Laszlo-dev] For Review: Change 20071015-ben-y Summary: Add left nav for reference

[John Sundman]

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
>>>
>>>
>>
>