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.


Reply via email to