[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