Skip to content

API docs#52

Merged
lonerapier merged 22 commits into
mainfrom
api-docs
Nov 24, 2025
Merged

API docs#52
lonerapier merged 22 commits into
mainfrom
api-docs

Conversation

@lonerapier
Copy link
Copy Markdown
Collaborator

Adds initial API docs for modules and other primtives.

Copy link
Copy Markdown
Contributor

@Autoparallel Autoparallel left a comment

Choose a reason for hiding this comment

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

Looking great!

My suggestions would be to make sure you add module level documentation everywhere.

There's some clippy attributes you can use to check that you have docs everywhere like: #![warn(missing_docs)] and another for docs in private impls too.

Comment thread mfkdf2/benches/factor_combination.rs
Comment thread mfkdf2/src/definitions/mfkdf_derived_key/strengthening.rs Outdated
Comment thread mfkdf2/src/definitions/mfkdf_derived_key/strengthening.rs
Comment thread mfkdf2/src/setup/factors/password.rs
Comment thread mfkdf2/src/setup/mod.rs Outdated
Comment thread mfkdf2/src/lib.rs Outdated
//! 3. K ← KDF(σ): Final static derived key
//! 4. βᵢ ← Update(Fᵢ, K, βᵢ): Optional state update (counters, hardening)
//!
//! ```text
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

mermaid could be good

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

does cargo doc render them?

Comment thread mfkdf2/src/lib.rs Outdated
Comment thread mfkdf2/src/lib.rs Outdated
Comment thread mfkdf2/src/log.rs
Comment thread mfkdf2/src/rng.rs Outdated
@Autoparallel
Copy link
Copy Markdown
Contributor

Oh, also, I'd consider building the docs and clicking around to see if it all looks right to you. That usually helps me.

Comment thread mfkdf2/src/definitions/mfkdf_derived_key/hints.rs
Copy link
Copy Markdown
Contributor

@Autoparallel Autoparallel left a comment

Choose a reason for hiding this comment

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

Amazing work @lonerapier !!

Comment thread mfkdf2/src/definitions/mfkdf_derived_key/mfdpg.rs Outdated
Comment thread mfkdf2/src/definitions/factor.rs
Comment thread mfkdf2/src/derive/factors/hotp.rs
Comment thread mfkdf2/src/derive/factors/totp.rs
@lonerapier lonerapier mentioned this pull request Nov 24, 2025
Base automatically changed from fix/todos to main November 24, 2025 10:26
@lonerapier lonerapier marked this pull request as ready for review November 24, 2025 16:19
@lonerapier
Copy link
Copy Markdown
Collaborator Author

all checks passed, merging it!

@lonerapier lonerapier merged commit 7c33c71 into main Nov 24, 2025
10 checks passed
@lonerapier lonerapier deleted the api-docs branch November 24, 2025 18:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants