DOC: Move PDF specification links (py-pdf#2983)

j-t-1 · web-flow · commit 952d80a57df2 · 2024-12-03T21:04:17.000+01:00
Move from constants.py to pdf-format.md, a more natural location.
diff --git a/docs/dev/pdf-format.md b/docs/dev/pdf-format.md
@@ -1,7 +1,13 @@
 # The PDF Format
 
 It is recommended to look in the PDF specification for details and clarifications.
-This is only intended to give a very rough overview of the format.
+
+* [PDF Specification Archive](https://pdfa.org/resource/pdf-specification-archive/)
+* [Portable Document Format Reference Manual, 1993. ISBN 0-201-62628-4](https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/pdfreference1.0.pdf)
+* [ISO 32000-1:2008 (PDF 1.7)](https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf)
+* ISO 32000-2:2020 (PDF 2.0)
+
+Below is only intended to give a very rough overview of the format.
 
 ## Overall Structure
 
diff --git a/pypdf/constants.py b/pypdf/constants.py
@@ -1,15 +1,4 @@
-"""
-PDF Specification Archive
-https://pdfa.org/resource/pdf-specification-archive/
-
-Portable Document Format Reference Manual, 1993. ISBN 0-201-62628-4
-https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/pdfreference1.0.pdf
-
-ISO 32000-1:2008 (PDF 1.7)
-https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf
-
-ISO 32000-2:2020 (PDF 2.0)
-"""
+"""Various constants, enums, and flags to aid readability."""
 
 from enum import Enum, IntFlag, auto, unique
 from typing import Dict, Tuple
