summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJon Bratseth <jonbratseth@yahoo.com>2016-06-20 17:26:11 +0200
committerGitHub <noreply@github.com>2016-06-20 17:26:11 +0200
commit05325795c30b7cbc5b6fcd78fdea3e3418ae686c (patch)
tree909f95d1a1864d3938d1116c1d2fa0d8d04ffcb0
parent37515efa5e5ef89ca363050b3c7083748bc680b4 (diff)
parent4bd2b627fabc9ba3db926725d03ab152b6213d8f (diff)
Merge pull request #120 from yahoo/bratseth/readme-fixes
Bratseth/readme fixes
-rw-r--r--README-documentation.md10
-rw-r--r--README.md2
2 files changed, 6 insertions, 6 deletions
diff --git a/README-documentation.md b/README-documentation.md
index 39d67f0a7bc..81d5d93199e 100644
--- a/README-documentation.md
+++ b/README-documentation.md
@@ -6,9 +6,9 @@ This document explains how to add documentation.
## Practical information
Vespa documentation is served using straightforward
-[https://help.github.com/categories/github-pages-basics/](GitHub Project pages)
+[GitHub Project pages](https://help.github.com/categories/github-pages-basics/)
with
-[https://help.github.com/categories/customizing-github-pages/](Jekyll).
+[Jekyll](https://help.github.com/categories/customizing-github-pages/).
To edit documentation check out and work off the branch gh-pages from Vespa repo.
This branch contains documentation instead of the code.
@@ -21,7 +21,7 @@ With Jekyll installed (follow the link above) you can use
to set up a local server at localhost:4000 to see the pages as they will look when served.
The layout is written in Bootstrap and we refer directly to the Bootstrap CSS.
-Refer to [http://getbootstrap.com/css/](Bootstrap documentation) if you need to
+Refer to [Bootstrap documentation](http://getbootstrap.com/css/) if you need to
add style effects to your page. Note that the enture documentation page content
is contained in a Bootstrap layout column with cilumn with 12. Please do not add custom style sheets
as it is a pain to maintain.
@@ -69,7 +69,7 @@ Add an *id* attribute to each heading such that link can refer to it: Use the ex
can be made without checking the source. Don't change headings/ids unless completely necessary as that breaks links.
Example:
-<h2 id="my-nice-heading">My nice Heading</h2>
-If this algorithmic transformation is followed it is possible to link to this section using <a href="doc.html#my-nice-heading"> without having to consult the html source of the page to find the right id.
+&lt;h2 id=&quot;my-nice-heading&quot;&gt;My nice Heading&lt;/h2&gt;
+If this algorithmic transformation is followed it is possible to link to this section using &lt;a href=&quot;doc.html#my-nice-heading&quot;&gt; without having to consult the html source of the page to find the right id.
*By Jon Bratseth in June 2016* \ No newline at end of file
diff --git a/README.md b/README.md
index fd7a4431db9..92cfbdb9771 100644
--- a/README.md
+++ b/README.md
@@ -52,4 +52,4 @@ Code licensed under the Apache 2.0 license. See LICENSE file for terms.
## Documenting your features
-See [README-documentation.md]. \ No newline at end of file
+See [README-documentation.md](README-documentation.md). \ No newline at end of file