Skip to content
This repository has been archived by the owner on Oct 19, 2024. It is now read-only.

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 subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants