docs: enhance documentation support and resolve clippy warnings

[JarvisCraft]

Description

This enhances documentation support by:

• resolving existing docs issues:
  • invalid links;
  • missing # Safety sections
• enabling automatic generation of # Features section;
• resolving rustdoc and clippy warnings which were polluting the log.

[JarvisCraft]

It's worth noting that

[workspace.package.metadata.docs.rs]
all-features = true

in workspace root failed to work (this section seems to be ignored, at least for this specific field).

[JarvisCraft]

@str4d, I've merged the latest main so that it now should comply with changes from #83.

[str4d]

Generally LGTM

[JarvisCraft]

@str4d, I guess there are no more changes here and the CI seems to fail due to some external error

[str4d]

Yeah, I've been trying to figure out a way around it, but unfortunately (for good security reasons) GitHub doesn't allow workflows run on PRs from third-party repos to have any write permissions to the base repo. And the Clippy action I found does a small write at the start to create a status entry if it doesn't exist, and that is what is blocking the actual Clippy checks from running. I've opened auguwu/clippy-action#15 upstream for this, but if this can't be addressed easily there, then I'll look into an alternative approach.

[str4d]

ACK with a few cleanups.