[jira] Commented: (DERBY-3072) User documentation for Table Functions

["Kim Haase (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-3072?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_12536284 ] 

Kim Haase commented on DERBY-3072:
----------------------------------

The content looks great, Rick, but there seems to be a problem with the table formatting. I don't think you intended all the contents of the third column to be in bold, did you? I cannot tell why that happened, but I do notice that the third column has the same colname value ("2") as the second column, in each row. You might want to name it "3" and see what happens.

Also, some consistency nits (feel free to ignore if they seem too picky): 

1) "Same" should be initial-capped in each row, as "Not supported" is. (You could remove the initial cap from "Not supported", but it's more consistent with common doc conventions to start the column text with a capital.

2) "Not supported (two instances) should not have a period at the end. (Again, you could put a period at the end of "Same", but doc conventions normally say don't put a period at the end of table cell content if it's not a sentence.


> User documentation for Table Functions
> --------------------------------------
>
>                 Key: DERBY-3072
>                 URL: https://issues.apache.org/jira/browse/DERBY-3072
>             Project: Derby
>          Issue Type: New Feature
>          Components: Documentation
>            Reporter: Rick Hillegas
>            Assignee: Rick Hillegas
>         Attachments: derby-3072-01-basic-aa.diff, derby-3072-01-basic-aa.tar, derby-3072-01-basic-ab.diff, derby-3072-01-basic-ab.tar, derby-3072-02-jsr169-aa.diff, derby-3072-02-jsr169-aa.tar
>
>
> This issue tracks changes to the user guides to describe table functions. This is the work needed for the  "Documentation" section of the functional spec attached to DERBY-716.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.