[higgins-dev] RE: Deployments page table changes

["Paul Trevithick" <paul@xxxxxxxxxxxxxxxxx>]

Daniel and Sergey,

Based on feedback from both of you there is now a new proposal for how to
document a deployment:

http://wiki.eclipse.org/index.php/Deployments#Conventions_Used_V2 

Please review. 

-Paul

Sergey,

1. I renamed your "I-Card Manager Enterprise Application" to "I-Card Manager
Web App" (because NOT speaking technically but speaking from the user's
perspective it is a web app (i.e. it has a web/HTML UI). Also, according to
v2 above, I think it needs a second row (for HBX) and an initial overview
para. 

2. Your RPPS Web App is, I believe, a web service (no HTML/UI, right?) or am
I wrong about this. We might want to just rename the section "RPPS Web
Service" (again from the user's perspective). As above I think it needs a
second row (for HBX) to be a useful.

As always, please push back on what I'm saying if I've got things wrong. As
you can see I'm trying to make this page accessible from a "users" (or at
least an assembler's) point of view who is NOT intimately familiar with
Higgins. They just want to come to this page and learn what you can do with
Higgins bits and pieces.

-Paul



________________________________________
From: Daniel Sanders [mailto:dsanders@xxxxxxxxxx] 
Sent: Thursday, February 08, 2007 6:49 PM
To: Paul Trevithick
Cc: higgins-dev@xxxxxxxxxxx
Subject: Re: Deployments page table changes

Paul,
 
Proposal looks good to me.  On the deployment scenario page we might want to
have the descriptive overview text to be followed by a table for the
assembly and build instruction that contains a line for each component -
instead of a bulleted list of components.  We might also want some actual
deployment "hints" - for things you might have had to do to "configure" the
deployment.  For example, the STS and LDAP CP have several configuration
files that ought to be explained a little - for anyone wanting to replicate
the deployment to their own servers.  In my case, there were also some
things I had to configure for tomcat so that the STS would get certain
parameters when it started up.  There may even be some unusual configuration
steps for non-Higgins components that would be useful to explain.  Perhaps a
"configuration" section or "deployment" section?
 
Daniel

>>> "Paul Trevithick" <paul@xxxxxxxxxxxxxxxxx> 2/8/2007 2:12 PM >>>
Daniel,

These deployments tables are full of redundant information. I have created
here [1] a proposed alternative. 

What do you think?

[1]
http://wiki.eclipse.org/index.php/Deployments#Paul.27s_Sandbox_.28alternate_
table_design_for_discussion_purposes.29 

-Paul