Stream: ideas

Topic: Doc server


view this post on Zulip Luke Boswell (Oct 07 2022 at 02:53):

I was thinking it would be good if we could add functionality to roc docs so that in addition to building the documentation it starts a local web server to serve the files and also opens the default web browser. I'm willing to try and implement if this is aligned with the intent for roc docs.

view this post on Zulip Brian Hicks (Oct 07 2022 at 14:16):

since we're already building them, can we just have an --open flag that opens the built location in a browser? No need for a server; they'll be static by that time won't they?

view this post on Zulip Brian Hicks (Oct 07 2022 at 14:16):

(I use cargo doc --open all the time and it works swimmingly.)

view this post on Zulip Richard Feldman (Oct 07 2022 at 14:22):

I like the --open idea regardless!

view this post on Zulip Richard Feldman (Oct 07 2022 at 14:25):

so I think it would be ideal if we could get everything working without the need for bundling a whole web server in the roc executable

view this post on Zulip Richard Feldman (Oct 07 2022 at 14:32):

but I think in order to do that, we'd need to have 2 different link styles - one for ../foo links (for file:// URLs being opened locally) and the other using /foo links (for use in deployed servers)


Last updated: Jun 16 2026 at 16:19 UTC