DOC: Move PDF specification links (#2983)

Move from constants.py to pdf-format.md, a more natural location.
py-pdf · Dec 3, 2024 · 952d80a · 952d80a
1 parent e1d65dc
commit 952d80a
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 13 deletions.
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