Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: fix broken links, update documentation #2203

Merged
merged 2 commits into from Feb 27, 2023

Conversation

DaniPopes
Copy link
Collaborator

@DaniPopes DaniPopes commented Feb 27, 2023

Motivation

commits:

  1. Allows running: cargo doc --workspace --all-features --no-deps --document-private-items
  2. While at it, updated all crates to have README.md + using #![doc = include_str!("../README.md")] in lib.rs

Solution

PR Checklist

  • Added Tests
  • Added Documentation
  • Updated the changelog
  • Breaking changes

@DaniPopes DaniPopes mentioned this pull request Feb 27, 2023
13 tasks
@@ -24,7 +24,7 @@ pub use compile::{
};

mod config;
pub use config::{AllowedLibPaths, PathStyle, ProjectPathsConfig, SolcConfig};
pub use config::{AllowedLibPaths, PathStyle, ProjectPaths, ProjectPathsConfig, SolcConfig};
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

ProjectPaths is referenced and exposed in ProjectPathsConfig, but not exported at the crate level, so it failed to document


pub use crate::core::{abi, types, utils};
#[doc(inline)]
pub use ethers_core::{abi, types, utils};
Copy link
Collaborator Author

@DaniPopes DaniPopes Feb 27, 2023

Choose a reason for hiding this comment

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

This (#[doc(inline)]) inlines the modules' docs as if we declared them in this scope, instead of being a "re-exported item". This is probably what the previous interface was going for, but this doesn't require duplicating docs and declaring new modules

Copy link
Collaborator

@mattsse mattsse left a comment

Choose a reason for hiding this comment

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

lgtm

@gakonst gakonst merged commit 203e350 into gakonst:master Feb 27, 2023
@DaniPopes DaniPopes deleted the docs/fix branch February 28, 2023 00:17
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.

None yet

3 participants