diff --git a/lib/get-all-pages.ts b/lib/get-all-pages.ts
index ecb1897..89785fe 100644
--- a/lib/get-all-pages.ts
+++ b/lib/get-all-pages.ts
@@ -34,6 +34,8 @@ export async function getAllPagesImpl(
       })
 
       if (map[canonicalPageId]) {
+        // you can have multiple pages in different collections that have the same id
+        // TODO: we may want to error if neither entry is a collection page
         console.warn('error duplicate canonical page id', {
           canonicalPageId,
           pageId,