[Laszlo-user] developer's guide title

[John Sundman]

I agree with Tucker.

For context, back in the foggy mists of time, we concocted the  
current longish names in order to make it easier to distinguish  
between the Developer's Guide and the Deployer's Guide -- they look  
so similar that people were failing to notice that there are actually  
two "books".

The Deployer's Guide (aka System Administrator's Guide, etc) is  
mostly about deploying proxied applications; that is, using the  
LPS.   However, there are some topics, such as security, that apply  
to both proxied and SOLO deployments.

jrs


On Oct 10, 2007, at 7:59 AM, P T Withington wrote:

> On 2007-10-09, at 18:45 EDT, Lou Iorio wrote:
>
>> JIRA
>>
>> The title of the Ddevelopers guide is currently:
>>
>> Software Engineer's Guide to Developing OpenLaszlo Applications
>>
>> And most links that point to it use:
>>
>> Software Developer's Guide
>>
>> I would like to change this to:
>>
>> OpenLaszlo Developer's Guide
>
> I like that, but maybe:
>
> OpenLaszlo _Application_ Developer's Guide
>
> Maybe I am being overly sensitive, but since we are an open-source  
> project, I think we need to be careful to distinguish between the  
> person who uses OL to make an application (Application Developer)  
> and the person for whom OL _is_ the application (OpenLaszlo  
> Implementor?), so the 'internals' version of the dev guide might be  
> called:
>
> OpenLaszlo Implementor's Guide
>
>> and change the links to match.
>>
>> The title of the deployer's guide is:
>>
>> System Administrator's Guide to Deploying OpenLaszlo Applications
>>
>> I would like to change this to:
>>
>> System Administrator's OpenLaszlo Application Deployer's Guide
>
> But not this.  Too many possessives for my little brain to parse.   
> Paralleling the earlier suggestions, how about:
>
> OpenLaszlo System Administrator's Guide
>
> or maybe you mean to say
>
> OpenLaszlo Application Deployer's Guide
>
> ?  But I think the target here is your general SysAdmin, not one  
> specialized to only OL deployment.