Is roc docs
broken? I can't figure out how to get it to generate docs for basic-cli
, which I'm sure I've done before. I've tried running almost the same command as we have in www/build.sh
except just using a release build of roc cli.
luke@192-168-1-104 basic-cli % ls
LICENSE ci file-testBROKEN.roc flake.nix src
README.md examples flake.lock generated-docs
luke@192-168-1-104 basic-cli % roc docs src/*.roc
🎉 Docs generated in ./generated-docs
luke@192-168-1-104 basic-cli % ls generated-docs
favicon.svg search.js styles.css
Yes, sort of, it's because of an issue in exposing modules. The fix is pretty complex but Richard is working on it.
Ahk, I started trying to find the issue. I figured out the VecMap docs_by_module: VecMap<ModuleId, ModuleDocumentation>
on LoadedModule
is empty. And then was looking at the HeaderType
in crates/compiler/load_internal/src/file.rs
and figured out it must have something to do with if the module is exposed by the platform... I'll pause on this one. Thanks Anton.
I have 2 different talks due next week, but I plan to get back to this afterwards!
Last updated: Jul 05 2025 at 12:14 UTC