diff --git a/core/includes/database.inc b/core/includes/database.inc
index 26cdcc0749bf44bcbdc6842b06bea8a4fcd2b170..5f085597ecca3d0001c980b3f9d986c8a55ac196 100644
--- a/core/includes/database.inc
+++ b/core/includes/database.inc
@@ -31,8 +31,10 @@
  * Most Drupal database SELECT queries are performed by a call to db_query() or
  * db_query_range(). Module authors should also consider using the
  * Drupal\Core\Database\Query\PagerSelectExtender for queries that return
- * results that need to be presented on multiple pages, and the Tablesort
- * Extender for generating appropriate queries for sortable tables.
+ * results that need to be presented on multiple pages
+ * (see https://drupal.org/node/508796), and the
+ * Drupal\Core\Database\Query\TableSortExtender for generating appropriate
+ * queries for sortable tables (see https://drupal.org/node/1848372).
  *
  * For example, one might wish to return a list of the most recent 10 rows
  * authored by a given user. Instead of directly issuing the SQL query