diff --git a/doc/dev/README.md b/doc/dev/README.md
index 6b3e6ce09fed..02185160ea01 100644
--- a/doc/dev/README.md
+++ b/doc/dev/README.md
@@ -6,7 +6,7 @@ Overview of the documents:
 - [Developer Set-Up](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/dev_setup.md) : How to create a development environment for this repo
 - [Release](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/release.md) : How to release a package when ready
 - [Packaging](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/packaging.md) : How to organize packaging information for packages under `azure`
-- [Testing](./tests.md): How to write unit and functional tests for a library
+- [Testing](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/tests.md): How to write unit and functional tests for a library
 - [Docstrings and Type hints](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/docstring_typehint.md): How to document an SDK for compatability with internal tools (API View) and our documentation at [MS Docs][ms_docs] and the [azure.github.io][azure_github_io] site.
 
 The [mgmt](https://github.com/Azure/azure-sdk-for-python/blob/main/doc/dev/mgmt) folder contains information specific to management packages (i.e. packages prefixed by `azure-mgmt`)
diff --git a/doc/dev/docstring_typehint.md b/doc/dev/docstring_typehint.md
index 2f8e17f8e253..0df46f8b3345 100644
--- a/doc/dev/docstring_typehint.md
+++ b/doc/dev/docstring_typehint.md
@@ -4,7 +4,7 @@ All public methods should have docstrings to document the parameters, keywords,
 
 * [Docstrings](#docstrings)
     * [Method Docstrings](#method_docstrings)
-    * [Model and Client Docstrings](#Model_and_Client_Docstrings)
+    * [Model and Client Docstrings](#model_and_Client_Docstrings)
 * [Type Hints](#type_hints)
     * [Type Hints for Python 2.7 and 3.5+](#type_hints_for_python_2.7_and_3.5+)
     * [Type Hints for Python 3.5+](#type_hints_for_python_3.5+)