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

Kim Haase commented on DERBY-2593:
----------------------------------

This is just from the writer's perspective, *not* the technical one -- just a 
few suggestions.

I would suggest changing

  Using an alternate form

to

  With the alternate form

(since there is only one alternate form; also, "Using" is a dangling participle 
that is confusing in this context)

In the third new paragraph, we don't usually put SQL clauses in bold, just in 
caps.

Also, the example should be consistent with the other syntax example in the 
margins and the use of bold. Dag's right about the semicolons too, of course.

In the third set of comments in the example, there's a typo ("exising").

Laura may have some ideas too, since she is more familiar with the SQL 
documentation.


> Add documentation for the CREATE TABLE as subquery clause
> ---------------------------------------------------------
>
>                 Key: DERBY-2593
>                 URL: https://issues.apache.org/jira/browse/DERBY-2593
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.3.0.0
>            Reporter: Dag H. Wanvik
>            Assignee: Bryan Pendleton
>             Fix For: 10.3.0.0
>
>         Attachments: docs.diff, docs_v2.diff, rrefsqlj24513.html, 
> rrefsqlj24513.html
>
>
> DERBY-64 introduced a way to create a new table on the basis of a subquery, cf
> SQL 2003 section 11.3: <as subquery clause>. 
> This is not yet documented.

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

Reply via email to