Hacker News

[rustdoc], Rust's API documentation generator, supports linking to Rust APIs by names, which is great DX because you don't have to hard-code URLs in docs, and it guarantees the links are correct. The same feature can be found in Javadoc, Go Doc, etc.

[mdBook] is another documentation/static-site generator written in Rust and widely used in the Rust community. It generates sites from Markdown (so like Docusaurus, VitePress, etc.)

Unlike rustdoc, mdBook doesn't have the same "linking by name" capability, which I find a bit lacking — so I made this program!

mdbook-rustdoc-link is an mdBook preprocessor that you can plug into your book projects. Using [rust-analyzer], it converts Rust API names to docs.rs permalinks, just like rustdoc does. It can link to APIs in your own crate and in your dependencies, without you having to manually search for and copy and paste URLs into your Markdown pages.

[rustdoc]: https://doc.rust-lang.org/rustdoc/what-is-rustdoc.html

[mdBook]: https://rust-lang.github.io/mdBook/

[rust-analyzer]: https://rust-analyzer.github.io/

Comments URL: https://news.ycombinator.com/item?id=43626696

Points: 1

# Comments: 0

Article URL: https://www.chrbutler.com/discernment-in-the-digital-age

Comments URL: https://news.ycombinator.com/item?id=43626672

Points: 2

# Comments: 0

Article URL: https://opensource.org/blog/there-are-no-degrees-of-open-why-openness-is-binary

Comments URL: https://news.ycombinator.com/item?id=43626648

Points: 3

# Comments: 0

Article URL: https://www.culturefoundry.com/cultivate/content-strategy/business-value-of-website-blogging/

Comments URL: https://news.ycombinator.com/item?id=43626647

Points: 1

# Comments: 0

Article URL: https://alyosha.net/posts/java-is-dying-and-it-paid-off-my-mortgage/

Comments URL: https://news.ycombinator.com/item?id=43626394

Points: 1

# Comments: 0

Article URL: https://neurosciencenews.com/adhd-music-focus-28556/

Comments URL: https://news.ycombinator.com/item?id=43626382

Points: 1

# Comments: 0

Article URL: https://news.osu.edu/ugh-not-that-song-background-music-impacts-employees/

Comments URL: https://news.ycombinator.com/item?id=43626352

Points: 1

# Comments: 0

Article URL: https://andriberger.com

Comments URL: https://news.ycombinator.com/item?id=43626326

Points: 3

# Comments: 0

Article URL: https://www.hudsonbaycapital.com/documents/FG/hudsonbay/research/638199_A_Users_Guide_to_Restructuring_the_Global_Trading_System.pdf

Comments URL: https://news.ycombinator.com/item?id=43626320

Points: 1

# Comments: 0

Article URL: https://world.hey.com/dhh/why-we-won-t-hire-a-junior-with-five-years-of-experience-0a548994

Comments URL: https://news.ycombinator.com/item?id=43626310

Points: 2

# Comments: 1

Article URL: https://ticketmaster.com/

Comments URL: https://news.ycombinator.com/item?id=43626271

Points: 1

# Comments: 0

Article URL: https://taildash.com

Comments URL: https://news.ycombinator.com/item?id=43626257

Points: 1

# Comments: 1

Article URL: https://wiki.alopex.li/TheStateOfGarnet2025

Comments URL: https://news.ycombinator.com/item?id=43626238

Points: 1

# Comments: 0

Article URL: https://wlach.github.io/gtha-electrification/

Comments URL: https://news.ycombinator.com/item?id=43626234

Points: 4

# Comments: 0

Article URL: https://www.youtube.com/watch?v=2eWlN_uiMIc

Comments URL: https://news.ycombinator.com/item?id=43626221

Points: 2

# Comments: 0

Article URL: https://www.thedrive.com/news/someone-made-a-4x4-honda-prelude-by-adding-a-second-engine

Comments URL: https://news.ycombinator.com/item?id=43626184

Points: 2

# Comments: 0

Article URL: https://blackbirdlc.github.io/aquafox/Homepage.html

Comments URL: https://news.ycombinator.com/item?id=43626168

Points: 3

# Comments: 1

Article URL: https://www.rollingstone.com/politics/politics-news/users-scammed-money-trump-truth-social-1235127287/

Comments URL: https://news.ycombinator.com/item?id=43626167

Points: 4

# Comments: 0

Article URL: https://ruby.social/@pushcx/114304225719976203

Comments URL: https://news.ycombinator.com/item?id=43626158

Points: 3

# Comments: 0

Article URL: https://github.com/openssl/openssl/blob/master/CHANGES.md

Comments URL: https://news.ycombinator.com/item?id=43626144

Points: 2

# Comments: 0