Open Ppjet6 opened 4 years ago
@kinnison, @GuillaumeGomez
There has long been a suggestion for "integrate mdbook into rustdoc and/or cargo doc
", but I cannot find the existing ticket I thought we had.
I think this is a good idea and something we might want to have on the long-term. However it brings some questions:
@kinnison also raised the question of what to do with these links in reexported symbols (when they reference some file local to the repo that isn't in the one that reexports).
This is doc(include)
, right? If so I think it should be closed in favor of https://github.com/rust-lang/rust/issues/44732.
@jyn514 sorta; you can take it that way, or you can take it as "be able to make mdbooks with rustdoc too", that is, expanding rustdoc to not just be for API documentation, but for all documentation in your project.
There is a related bug to this against Cargo as well: rust-lang/cargo#739
It doesn't seem to be possible to include external markdown files without using
include_file!
. By this I mean your file would have to be included in your code hierarchy and it's not possible to have it as a separate hierarchy.This could be useful for getting-started (even though usually included in the README), debugging-tips, or various tutorials.
A few ideas where this could be used: