[doc] Suggestion for pasting links to the documentation

[Jeff Levitt <de...@mylevita.com>]

I have noticed a couple of emails lately referring to
the documentation that is sourced in DITA. 
Specifically, they are references to individual topics
within manuals using the output that creates many html
files instead of one large one.  However, it should be
noted that simply grabbing the URL from your browser
gives you the root directory for that manual, and not
that specific topic.

For example, Satheesh just sent out an email
referencing SYSCS_UTIL.SYSCS_IMPORT_TABLE, but the
link went to
http://incubator.apache.org/derby/docs/ref/

That link is just the Reference Manual link, and does
not specifically go to SYSCS_UTIL.SYSCS_IMPORT_TABLE. 


In order to get the specific link for a topic, right
click on the link to it in the NAV tree, and view its
properties.  The target URL is the correct URL.  So in
Satheesh's post, the link you want is:

http://incubator.apache.org/derby/docs/ref/rrefimportproc.html

Just a helpful hint for anyone that wants to post
links to the docs on the mailing list...

Re: [doc] Suggestion for pasting links to the documentation

[Satheesh Bandaram <sa...@Sourcery.Org>]

Thanks for the tip. I will use it next time. I noticed the URL wasn't
pointing to the required section, but I thought people can just search
once there in the manual. But, this is better. :-)

Satheesh

Jeff Levitt wrote:

>I have noticed a couple of emails lately referring to
>the documentation that is sourced in DITA. 
>Specifically, they are references to individual topics
>within manuals using the output that creates many html
>files instead of one large one.  However, it should be
>noted that simply grabbing the URL from your browser
>gives you the root directory for that manual, and not
>that specific topic.
>
>For example, Satheesh just sent out an email
>referencing SYSCS_UTIL.SYSCS_IMPORT_TABLE, but the
>link went to
>http://incubator.apache.org/derby/docs/ref/
>
>That link is just the Reference Manual link, and does
>not specifically go to SYSCS_UTIL.SYSCS_IMPORT_TABLE. 
>
>
>In order to get the specific link for a topic, right
>click on the link to it in the NAV tree, and view its
>properties.  The target URL is the correct URL.  So in
>Satheesh's post, the link you want is:
>
>http://incubator.apache.org/derby/docs/ref/rrefimportproc.html
>
>Just a helpful hint for anyone that wants to post
>links to the docs on the mailing list...
>
>
>
>  
>