[
https://issues.apache.org/jira/browse/DERBY-2194?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12462041
]
Kim Haase commented on DERBY-2194:
----------------------------------
It would be useful to put that information somewhere, although the writing
guidelines page might be more suitable. The DITA page is focused mainly on
tools and setup.
Parts of the Working with Derby updating task may need to be done for minor
releases as well, since the release tag changes every time.
What else might go into this list? Updating the conrefs files comes to mind.
I'm not sure what else.
> A few more problems with Working with Derby manual
> --------------------------------------------------
>
> Key: DERBY-2194
> URL: https://issues.apache.org/jira/browse/DERBY-2194
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Reporter: Kim Haase
> Assigned To: Kim Haase
> Priority: Minor
> Fix For: 10.2.3.0
>
> Attachments: DERBY-2194.diff, DERBY-2194.zip
>
>
> After rerunning the tasks in Working With Derby, I found a few more issues.
> 1) There's a step-ordering problem: The Introduction tells users to verify
> that DERBY_HOME is set, but instructions for setting it don't appear till
> Activity 1. The instructions for setting DERBY_HOME should be moved to the
> Introduction.
> 2) In step 2 of Activity 1, add a statement that ij commands can be in either
> uppercase or lowercase, to prevent confusion when both forms are used.
> 3) Fix horizontal and vertical spacing in command and code examples.
> 4) Correct the derby.log output and description.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
https://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
