backport link fixes from #260

fixes #272

Author: tarzanek

docs/source/configuration.rst

@@ -328,6 +328,8 @@ The optional ``renames`` property lists the item columns to rename along the mig
       to: <target-column-name>
     # ... other columns to rename
 
+.. _config-savepoints:
+
 ----------
 Savepoints
 ----------
@@ -365,6 +367,8 @@ The ``validation`` field and its properties are mandatory only when the applicat
     # What difference in ms should we allow between timestamps?
     timestampMsTolerance: 0
 
+.. _aws-authentication:
+
 ------------------
 AWS Authentication
 ------------------

docs/source/migrate-from-cassandra-or-parquet.rst

@@ -2,7 +2,7 @@
 Migrate from Apache Cassandra or from a Parquet File
 ====================================================
 
-This page explains how to fill the ``source`` and ``target`` properties of the `configuration file <../configuration>`_ to migrate data:
+This page explains how to fill the ``source`` and ``target`` properties of the :doc:`configuration file </configuration>` to migrate data:
 
 - from Apache Cassandra, ScyllaDB, or from a `Parquet <https://parquet.apache.org/>`_ file,
 - to Apache Cassandra or ScyllaDB.
@@ -124,7 +124,7 @@ In case the object is not public in the S3 bucket, you can provide the AWS crede
 
 Where ``<access-key>`` and ``<secret-key>`` should be replaced with your actual AWS access key and secret key.
 
-The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the `configuration reference <../configuration#aws-authentication>`__ for more details.
+The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the :ref:`configuration reference <aws-authentication>` for more details.
 
 ---------------------------
 Configuring the Destination

docs/source/migrate-from-dynamodb.rst

@@ -2,7 +2,7 @@
 Migrate from DynamoDB
 =====================
 
-This page explains how to fill the ``source`` and ``target`` properties of the `configuration file <../configuration>`_ to migrate data:
+This page explains how to fill the ``source`` and ``target`` properties of the :doc:`configuration file </configuration>` to migrate data:
 
 - from a DynamoDB table, a ScyllaDB Alternator table, or a `DynamoDB S3 export <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/S3DataExport.HowItWorks.html>`_,
 - to a DynamoDB table or a ScyllaDB Alternator table.
@@ -57,7 +57,7 @@ In practice, your source database (DynamoDB or Alternator) may require authentic
 
 Where ``<access-key>`` and ``<secret-key>`` should be replaced with your actual AWS access key and secret key.
 
-The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the `configuration reference <../configuration#aws-authentication>`_ for more details.
+The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the :ref:`configuration reference <aws-authentication>` for more details.
 
 Last, you can provide the following optional properties:
 
@@ -150,7 +150,7 @@ Additionally, you can provide the following optional properties:
 
 Where ``<host>``, ``<port>``, ``<region>``, ``<access-key>``, and ``<secret-key>`` should be replaced with your specific values.
 
-The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the `configuration reference <../configuration#aws-authentication>`_ for more details.
+The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the :ref:`configuration reference <aws-authentication>` for more details.
 
 ---------------------------
 Configuring the Destination
@@ -214,4 +214,4 @@ Additionally, you can also set the following optional properties:
 
 Where ``<host>``, ``<port>``, ``<region>``, ``<access-key>``, and ``<secret-key>`` are replaced with your specific values.
 
-The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the `configuration reference <../configuration#aws-authentication>`_ for more details.
+The Migrator also supports advanced AWS authentication options such as using `AssumeRole <https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_cross-account-with-roles.html>`_. Please read the :ref:`configuration reference <aws-authentication>` for more details.