[Openinteract-dev] Random tidbits on OI2

[Greg F. <gre...@ya...>]

More simple tidbits:

1. OpenInteract2::Manual::Intro, last sentence of "Controller"
   description says "... from once place."  (should be "from one
   place.")

2. In OpenInteract2::Manual::QuickStart, the first bullet under
   "Prerequisites" states "This is the normal four-step installation
   process...".  It would be nice to have a link to the normal process.

3. In OpenInteract2::Manual::QuickStart, the last bullet under
   "Prerequisites" has a link to "SEE ALSO", but it doesn't work.
   That HREF is to "#" but should be to "#SEE_ALSO".

4. In OpenInteract2::Manual::QuickStart, it should be explicitly stated
   that LWP is being used as the webserver.  This should probably be
   stated before or at the very beginning of "Creating A Website".  I
   found myself wondering if/how I was going to set up Apache without
   affecting my existing website.

5. In OpenInteract2::Manual::QuickStart, it says that the daemon can
   be killed by kill -15 `cat oi2.pid`, but nowhere did we state where
   oi2.pid is created (in $PWD when oi2_daemon is run).  If there is a
   way to specify where the PID file can go, this should be indicated.
   If there isn't, then there should be :-)

6. Now that I have my very own OI2 running (the QuickStart, running
with
   LWP and SQLite), I login as superuser and go to "Object Activity". 
I
   set "Activity By" to superuser and click "Search".  The resulting
   table shows dates of "DateTime=HASH(0x891d9c4)" instead of the
actual
   date/time.

7. In OpenInteract2::Manual::Architecture, Step 0 of TRACING A REQUEST
   says "[The adapter] will run a number of processes at server
startup"
   I don't believe that a number of "processes" run, but that a bunch
   of "tasks" or "jobs" are performed.  Since its talking about the
   startup of a server, the phrase "process" might make a developer
   or administrator leary of OI2.

8. In OpenInteract2::Manual::Architecture, Step 6 of TRACING A REQUEST
   is missing the first letter of the very first word ("he" instead of
   "The").

9. In OpenInteract2::Manual::Architecture, Step 7 of TRACING A REQUEST
   the logic of the section is backwards.  It starts off with "Find out
   if the task is invalid", but then lists points of validity (not
   invalidity).  Also, the very last point is vague (*what* is
   listed there?).

Hope this helps,
greg_fenton.

=====
Greg Fenton
gre...@ya...

__________________________________
Do you Yahoo!?
SBC Yahoo! DSL - Now only $29.95 per month!
http://sbc.yahoo.com