[
https://issues.apache.org/jira/browse/DERBY-2389?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12645808#action_12645808
]
Kim Haase commented on DERBY-2389:
----------------------------------
I'm glad you noticed this, Dag, because I was wondering about my solution to
this problem.
There is a six-page section called "Working with Derby properties" that is
mainly conceptual and task-oriented, rather than reference. I didn't want to
move it all into the Reference Manual because the Reference Manual is not
really for conceptual and how-to information -- I copied over the most basic
information (scope) that's needed to understand the "Derby properties" topic
and left the rest in the Tuning Guide. But I'm not sure it belongs in the
Tuning Guide either. It might make more sense to put it in part 2 of the Admin
Guide, along with the other tasks there.
What do you think?
> DOCS - Move Derby system and properties info from Tuning Guide into Reference
> Manual
> ------------------------------------------------------------------------------------
>
> Key: DERBY-2389
> URL: https://issues.apache.org/jira/browse/DERBY-2389
> Project: Derby
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 10.4.2.0
> Reporter: Laura Stewart
> Assignee: Kim Haase
> Attachments: DERBY-2389-adminguide.diff, DERBY-2389-adminguide.stat,
> DERBY-2389-adminguide.zip, DERBY-2389-devguide.diff,
> DERBY-2389-devguide.stat, DERBY-2389-devguide.zip, DERBY-2389-getstart.diff,
> DERBY-2389-getstart.stat, DERBY-2389-getstart.zip, DERBY-2389-ref.diff,
> DERBY-2389-ref.stat, DERBY-2389-ref.zip, DERBY-2389-ref2.zip,
> DERBY-2389-tuning.diff, DERBY-2389-tuning.stat, DERBY-2389-tuning.zip
>
>
> From Derby User list:
> On 2/21/07, Anders Morken <[EMAIL PROTECTED]> wrote:
> > Shooting from the hip here, but one thing that has occured to me a few
> > times as I've browsed the docs to figure something out is that I
> > intuitively expect Derby system and database properties (especially the
> > non-performance-related) to be documented in the reference guide, not
> > the tuning guide. =)
> On 2/21/07, Oystein Grovlen - Sun Norway <[EMAIL PROTECTED]> wrote:
> > I agree on this. I would have preferred that all "facts" where
> > presented in the Reference Manual, and that the other manuals where more
> > "pedagogical" presentations of the same material. Currently, it is not
> > very intuitive to determine which manual has the information you are
> > looking for.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
