db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-2454) Derby Doc Web pages - update FAQ, patch procedures, and tips on formatting
Date Wed, 21 Mar 2007 14:33:32 GMT

    [ 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.


Mime
View raw message