[
https://issues.apache.org/jira/browse/DERBY-2454?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12482779
]
Kim Haase commented on DERBY-2454:
----------------------------------
Thanks a lot, Laura, these look great. Just a few more comments --
1) In dita.html, you don't seem to have implemented Jean's suggestion about
running ant. Are you leaving it for her next round of edits (as she volunteered
to do) or was this just an oversight?
2) In guidelines.html, have you thought of aligning the table rows at the top?
Currently the tables are a little hard to read because it is not clear which
text belongs to which topic. I think that for each table with multiple-line
cells, you could change each <tr> tag to
<tr valign="top">
Except maybe for the first row (the header), which is probably more readable if
it is set to
<tr valign="bottom">
3) In docsfaq.html, there's one slight problem resulting from the fix in "Cross
references: To a Web site". There is a hyphen after the scope attribute instead
of an equals sign:
scope-"external"
should be
scope="external"
> Derby Doc Web pages - update FAQ, patch procedures, and tips on formatting
> --------------------------------------------------------------------------
>
> Key: DERBY-2454
> URL: https://issues.apache.org/jira/browse/DERBY-2454
> Project: Derby
> Issue Type: Improvement
> Components: Web Site
> Reporter: Laura Stewart
> Assigned To: Laura Stewart
> Attachments: derby2454.zip, derby2454_2.zip, derby2454_3.zip,
> docpages031507_2.diff, docpages032007_3.diff, docpages032007_4.diff
>
>
> Update the FAQ:
> - How to create cross-references to other topics, other books, and web sties
> - How to format code examples
> Update DITA page:
> - Improve instructions on Creating a patch
> - Improve instructions on Commiting a patch
> Update Guidelines page:
> - Add a section on "Tips to Improve Output Formats"
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
