🐛 Entirely disable PDF build (#660)

## Description

#659 did not resolve the issue described there. One option in
`readthedocs.yml` was still missed. This PR solves this issue.

Additionally, this PR enables the concatenation of class and `__init__`
docstrings on the Python side.

## Checklist:

<!---
This checklist serves as a reminder of a couple of things that ensure
your pull request will be merged swiftly.
-->

- [x] The pull request only contains commits that are focused and
relevant to this change.
- [ ] I have added appropriate tests that cover the new/changed
functionality.
- [x] I have updated the documentation to reflect these changes.
- [x] I have added entries to the changelog for any noteworthy
additions, changes, fixes or removals.
- [x] I have added migration instructions to the upgrade guide (if
needed).
- [x] The changes follow the project's style guidelines and introduce no
new warnings.
- [x] The changes are fully tested and pass the CI checks.
- [x] I have reviewed my own code changes.

---------

Signed-off-by: Yannick Stade <[email protected]>

Author: ystade

.readthedocs.yaml

@@ -1,7 +1,7 @@
 version: 2
 
 formats:
-  - pdf
+  #  - pdf
   - htmlzip
 
 build:

CHANGELOG.md

@@ -7,6 +7,13 @@ This project adheres to [Semantic Versioning], with the exception that minor rel
 
 ## [Unreleased]
 
+## [3.1.2] - 2025-05-27
+
+### Fixed
+
+- 🐛 Entirely deactivate PDF export in documentation build ([#660]) ([**@ystade**])
+- 📝 Append the docstring for the `__init__` method to the class docstring in the documentation ([#660]) ([**@ystade**])
+
 ## [3.1.1] - 2025-05-27
 
 ### Fixed
@@ -56,14 +63,16 @@ _📚 Refer to the [GitHub Release Notes] for previous changelogs._
 
 <!-- Version links -->
 
-[unreleased]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.1.1...HEAD
+[unreleased]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.1.2...HEAD
+[3.1.2]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.1.1...v3.1.2
 [3.1.1]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.1.0...v3.1.1
 [3.1.0]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.0.0...v3.1.0
 [3.0.0]: https://github.com/munich-quantum-toolkit/qmap/compare/v2.8.0...v3.0.0
 [2.8.0]: https://github.com/munich-quantum-toolkit/qmap/releases/tag/v2.8.0
 
 <!-- PR links -->
 
+[#660]: https://github.com/munich-quantum-toolkit/qmap/pulls/660
 [#659]: https://github.com/munich-quantum-toolkit/qmap/pulls/659
 [#624]: https://github.com/munich-quantum-toolkit/qmap/pulls/624
 [#621]: https://github.com/munich-quantum-toolkit/qmap/pulls/621

UPGRADING.md

@@ -4,7 +4,7 @@ This document describes breaking changes and how to upgrade. For a complete list
 
 ## [Unreleased]
 
-## [3.1.1]
+## [3.1.0]
 
 This minor release initiates the efforts to re-structure the Python bindings and make them more modular.
 Even tough this is not a breaking change, it is worth mentioning to developers of MQT QMAP that all Python code (except tests) has been moved to the top-level `python` directory.
@@ -43,6 +43,6 @@ Most modern operating systems should have this version available in their packag
 Alternatively, CMake can be conveniently installed from PyPI using the [`cmake`](https://pypi.org/project/cmake/) package.
 
 [MQT SyReC]: https://github.com/cda-tum/mqt-syrec
-[unreleased]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.1.1...HEAD
-[3.1.1]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.0.0...v3.1.1
+[unreleased]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.1.0...HEAD
+[3.1.0]: https://github.com/munich-quantum-toolkit/qmap/compare/v3.0.0...v3.1.0
 [3.0.0]: https://github.com/munich-quantum-toolkit/qmap/compare/v2.8.0...v3.0.0

docs/conf.py

@@ -153,6 +153,7 @@ def format_url(self, _e: Entry) -> HRef:  # noqa: PLR6301
     "show-module-summary",
 ]
 autoapi_keep_files = True
+autoapi_python_class_content = "both"
 add_module_names = False
 toc_object_entries_show_parents = "hide"
 python_use_unqualified_type_names = True

python/mqt/qmap/na/zoned.pyi

@@ -12,6 +12,7 @@ from mqt.core.ir import QuantumComputation
 
 class ZonedNeutralAtomArchitecture:
     """Class representing a Zoned Neutral Atom Architecture."""
+
     @classmethod
     def from_json_file(cls, filename: str) -> ZonedNeutralAtomArchitecture:
         """Create an architecture from a JSON file.
@@ -41,6 +42,7 @@ class ZonedNeutralAtomArchitecture:
 
 class RoutingAgnosticCompiler:
     """MQT QMAP's routing-agnostic Zoned Neutral Atom Compiler."""
+
     def __init__(
         self,
         arch: ZonedNeutralAtomArchitecture,
@@ -95,6 +97,7 @@ class RoutingAgnosticCompiler:
 
 class RoutingAwareCompiler:
     """MQT QMAP's routing-aware Zoned Neutral Atom Compiler."""
+
     def __init__(
         self,
         arch: ZonedNeutralAtomArchitecture,