diff --git a/src/sphinx/Community/Bintray-For-Plugins.rst b/src/sphinx/Community/Bintray-For-Plugins.rst
index f3955b38c..35efa331a 100644
--- a/src/sphinx/Community/Bintray-For-Plugins.rst
+++ b/src/sphinx/Community/Bintray-For-Plugins.rst
@@ -43,7 +43,7 @@ Tags
 Once this is done, you can begin to configure your sbt-plugins to publish to bintray.
 
 Add the bintray-sbt plugin to your build.
-========================================
+=========================================
 
 First, add the bintray-sbt to your plugin build.
 
diff --git a/src/sphinx/Extending/Build-Loaders.rst b/src/sphinx/Extending/Build-Loaders.rst
index bde7f6eb4..5e3ee1220 100644
--- a/src/sphinx/Extending/Build-Loaders.rst
+++ b/src/sphinx/Extending/Build-Loaders.rst
@@ -245,7 +245,7 @@ The BuildDependencies type
 --------------------------
 
 The type of the :key:`buildDependencies` setting is
-`BuildDependencies </api/sbt/BuildDependencies.html>`_.
+`BuildDependencies <../../api/sbt/BuildDependencies.html>`_.
 `BuildDependencies` provides mappings from a project to its aggregate
 or classpath dependencies. For classpath dependencies, a dependency has
 type `ClasspathDep[ProjectRef]`, which combines a `ProjectRef` with
diff --git a/src/sphinx/Extending/Input-Tasks.rst b/src/sphinx/Extending/Input-Tasks.rst
index 69f06a43f..a3bd2ac03 100644
--- a/src/sphinx/Extending/Input-Tasks.rst
+++ b/src/sphinx/Extending/Input-Tasks.rst
@@ -22,7 +22,7 @@ represents a task. Define a new input task key using the
       val demo = inputKey[Unit]("A demo input task.")
 
 The definition of an input task is similar to that of a normal task, but it can
-also use the result of a `Parser </Detailed-Topics/Parsing-Input>`_ applied to
+also use the result of a :doc:`Parser </Detailed-Topics/Parsing-Input>` applied to
 user input.  Just as the special `value` method gets the value of a
 setting or task, the special `parsed` method gets the result of a `Parser`.
 
diff --git a/src/sphinx/Getting-Started/Custom-Settings.rst b/src/sphinx/Getting-Started/Custom-Settings.rst
index 834769ed7..59107d452 100644
--- a/src/sphinx/Getting-Started/Custom-Settings.rst
+++ b/src/sphinx/Getting-Started/Custom-Settings.rst
@@ -49,15 +49,14 @@ Implementing a task
 Once you've defined a key for your task, you'll need to complete it
 with a task definition. You could be defining your own task, or you
 could be planning to redefine an existing task. Either way looks the
-same; use `:=` to associate some code with the task key:
+same; use `:=` to associate some code with the task key:  ::
 
-::
     val sampleStringTask = settingKey[String]("A sample string task.")
     
     val sampleIntTask = settingKey[String]("A sample int task.")
-
+    
     sampleStringTask := System.getProperty("user.home")
-
+    
     sampleIntTask := {
       val sum = 1 + 2
       println("sum: " + sum)
@@ -93,4 +92,3 @@ This page has been a quick taste; there's much much more about custom
 tasks on the :doc:`/Detailed-Topics/Tasks` page.
 
 Move on to :doc:`Full-Def`.
-
diff --git a/src/sphinx/faq.rst b/src/sphinx/faq.rst
index 1d1382e37..b44c7d0f7 100644
--- a/src/sphinx/faq.rst
+++ b/src/sphinx/faq.rst
@@ -108,8 +108,8 @@ What is `ModuleID`, `Project`, ...?
 To figure out an unknown type or method, have a look at the
 :doc:`Getting Started Guide </Getting-Started/Welcome>` if you have not.
 Also try the :doc:`index </Name-Index>` of commonly used methods, values, and types,
-the `API Documentation <../api/index>`_ and the
-`hyperlinked sources <../sxr/index>`_.
+the `API Documentation <../api/>`_ and the
+`hyperlinked sources <../sxr/>`_.
 
 How do I add files to a jar package?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~