Documentation issue regarding "Setting up Synapse Datasources" and " Setting up
Derby database server"
------------------------------------------------------------------------------------------------------
Key: SYNAPSE-299
URL: https://issues.apache.org/jira/browse/SYNAPSE-299
Project: Synapse
Issue Type: Bug
Components: Documentation
Affects Versions: 1.2-QA-B1
Environment: Ubuntu 7.10, Java version "1.5.0_14", Firefox2.0.0.12
Reporter: Evanthika Amarasiri
Issue 1
=====
In the Synapse_Samples_Setup.html under the heading "Setting up Derby database
server", the commands you have given to create connections, databases and
tables are not very clear. Make them bold and stand out and show the commands
clearly to the user. Make sure that the extra numbers which are there for the
steps are also removed.
Issue 2
====
Also under the heading "Setting up Synapse DataSources", you have said "Please
follows the above (Setting up Derby Database server) section and setup database
for 'jdbc:derby://localhost:1527/lookupdb' and
'jdbc:derby://localhost:1527/reportdb' using user name and password as
'synapse'." but this does not give a clear meaning for the user that he should
also create the tables and insert the data as well. Therefore clearly state
that the user should create two databases and also he/she should create the
tables and insert the data as well.
Issue 3
=====
In addition under Sample 363 in the Synapse_Samples.html when you say
"Prerequisites: Setting up DataBase and DataSources according to the sample
setup guide." specify the link to the Samples_Setup.html here.
Issue 4
=====
Another issue that I found out was that in the same sample, the way that you
have asked the user to start the sample is invalid. You have given it as
"synapse -sample 3623". Please correct this as well.
Don't just say "Then the console output". Please rephrase this. Also without
just giving out the console output as
INFO LogMediator text = ** Looking up from the Database **
...
ID - c1
...
INFO LogMediator text = ** Reporting to the Database **
INFO LogMediator text = ** Looking up from the Database **
INFO LogMediator text = Stock price - 183.3635460215262
give it as follows
INFO LogMediator text = ** Looking up from the Database **
...
ID - c1
...
INFO LogMediator text = ** Reporting to the Database **
...
INFO LogMediator text = ** Looking up from the Database **
...
INFO LogMediator text = Stock price - 183.3635460215262
so that the user would know there are other logs being printed in between these
lines.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
