Skip to content

Add docs for ML-DSA-65#14568

Merged
alex merged 6 commits intopyca:mainfrom
trail-of-forks:dm/mldsa-docs
Apr 2, 2026
Merged

Add docs for ML-DSA-65#14568
alex merged 6 commits intopyca:mainfrom
trail-of-forks:dm/mldsa-docs

Conversation

@facutuesca
Copy link
Copy Markdown
Contributor

@facutuesca facutuesca commented Mar 31, 2026

Follow-up to #14404, adds the docs for the new ML-DSA-65 implementation.

Since CI runs doctests only with OpenSSL, I've conditionally disabled them for these ML-DSA-65 docs. Should we add a new CI job for doctests with AWS-LC?

(Part of #14337)

Signed-off-by: Facundo Tuesca <facundo.tuesca@trailofbits.com>
Copy link
Copy Markdown
Member

@alex alex left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mostly looks good. We should also add a changelog entry!

rsa
dh
dsa
mldsa
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's organize this up at the top, no reason not to put PQC first!

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

@@ -0,0 +1,231 @@
.. hazmat::

ML-DSA-65 signing
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should probably just title his ML-DSA Signing, as I assume we're going to follow up with other lengths shortly :-)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

docs/conf.py Outdated
Comment on lines +54 to +55
from cryptography.hazmat.bindings._rust import openssl as _rust_openssl
SKIP_MLDSA = not _rust_openssl.CRYPTOGRAPHY_IS_AWSLC
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't there a method on backend we can use?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

Signed-off-by: Facundo Tuesca <facundo.tuesca@trailofbits.com>
Signed-off-by: Facundo Tuesca <facundo.tuesca@trailofbits.com>
Signed-off-by: Facundo Tuesca <facundo.tuesca@trailofbits.com>
Signed-off-by: Facundo Tuesca <facundo.tuesca@trailofbits.com>
@alex alex merged commit 88b3d81 into pyca:main Apr 2, 2026
68 checks passed
@facutuesca facutuesca deleted the dm/mldsa-docs branch April 2, 2026 12:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants