diff --git a/docs/contributing.md b/docs/contributing.md
index 6627bd85..0490de33 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -13,10 +13,9 @@ possible.
 
 ## Sending Pull Requests
 
-All pull requests should solve an existing issue.
+All pull requests should solve an existing issue. Make sure to add the issue number to the pull request, linking them together.
 
-To submit a new pull request, fork the repository. Create a new branch for your feature or fix. Make your
-changes then submit a pull request.
+To submit a new pull request, fork the repository. Create a new branch for your feature or fix. Make your changes then submit a pull request.
 
 ## Markdown and Writing Style
 
diff --git a/docs/dir/overview.md b/docs/dir/overview.md
index 5eea6140..a07c87c3 100644
--- a/docs/dir/overview.md
+++ b/docs/dir/overview.md
@@ -25,7 +25,7 @@ While all record data is modeled using the [OASF](../oasf/open-agentic-schema-fr
 leveraged for content routing in the distributed network of directory servers.
 The ADS specification is under active development and is published as an
 Internet Draft at [ADS Spec](https://spec.dir.agntcy.org). The source code is
-available in the [ADS Spec sources](https://github.com/agntcy).
+available in the [ADS Spec sources](https://github.com/agntcy/dir-spec).
 The current reference implementation, written in Go, provides server and client
 nodes with gRPC and protocol buffer interfaces. The directory record storage is
 built on [ORAS](https://oras.land) (OCI Registry As Storage), while data