Skip to content

Conversation

@Sukuna0007Abhi
Copy link

Add Documentation checks to Cl pipeline

  • Added 'cargo doc' with RUSTDOCFLAGS="-D warnings" to CI workflow
  • Ensures documentation builds successfully and catches doc warnings
  • Included --document-private-items flag for comprehensive doc coverage
  • Fixed dead code warnings in base64.rs using #[allow(dead_code)]
  • Resolves issue documention should be checked by the CI #23: documentation should be checked by the CI

The CI now validates:

  1. Code formatting (cargo fmt)
  2. Clippy lints
  3. Documentation generation (NEW)
  4. Build process
  5. Test execution

Fixes #23

- Add 'cargo doc' with RUSTDOCFLAGS="-D warnings" to CI workflow
- Ensures documentation builds successfully and catches doc warnings
- Include --document-private-items flag for comprehensive doc coverage
- Fix dead code warnings in base64.rs using #[allow(dead_code)]
- Resolves issue veraison#23: documentation should be checked by the CI

The CI now validates:
1. Code formatting (cargo fmt)
2. Clippy lints
3. Documentation generation (NEW)
4. Build process
5. Test execution

Signed-off-by: Sukuna0007Abhi <appsonly310@gmail.com>
}

/// a `Vec<u8>` encoded as base64 in human readable serialization
#[allow(dead_code)]
Copy link
Contributor

@setrofim setrofim Oct 13, 2025

Choose a reason for hiding this comment

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

This isn't right. Please remove this and the other dead code allows in this pull. None of that should be dead code. If it's being reported as such then something else is going wrong (note: I've checked locally on the latest main, and I'm not seeing any dead code warnings without these allows).

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.

documention should be checked by the CI

2 participants