kubo / ruby-oci8

Ruby-oci8 - Oracle interface for ruby
Other
169 stars 75 forks source link

Fix links in README #98

Closed mdsrosa closed 9 years ago

mdsrosa commented 9 years ago

Fix some links in the README file.

kubo commented 9 years ago

I don't accept this pull request because I use the link style by intent. I'll explain the reason later.

mdsrosa commented 9 years ago

Hmm. Can't wait to know the reason. :smile: Thanks!

kubo commented 9 years ago

Three link styles are used in ruby-oci8 documents written by markdown.

I uses markdown style for external links and yard style for links to a file in the repository. If markdown style is used for the latter, the links are valid in github.com and rubydoc.info, but dangling in html files generated by yard command because generated html files' extensions are changed to html.

table of links to a file in the repositoy

makrdown style link yard style link
github.com valid as is
rubydoc.info valid valid
yard command dangling valid

I don't like dangling links.