[Laszlo-user] developer's guide title

Lou Iorio lou at louiorio.com
Wed Oct 10 06:38:23 PDT 2007


I also agree with Tucker.

I like "OpenLaszlo System Administrator's Guide" for the deployer's  
guide, as it removes any confusion with the developer's guide.

Lou
-----------------------
On Oct 10, 2007, at 9:26 AM, John Sundman wrote:

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



More information about the Laszlo-user mailing list