dune build @doc doesn't update generated documentation properly

[jasonyu1996]

Expected Behavior

I made some changes to the inline docs and reran dune build @doc, expecting it to update the generated documentation.

Actual Behavior

Sometimes it works. Sometimes the files do not get updated. Sometimes it is updated but the unchanged modules disappear from the index page.

Specifications

• Version of dune (output of dune --version): 3.16.0
• Version of ocaml (output of ocamlc --version): 5.2.0
• Operating system (distribution and version): Ubuntu 22.04.5 LTS

Additional information

I tried disabling cache but it didn't help. Here's the output of DUNE_CACHE=disabled dune build @doc --verbose, which doesn't seem to produce much helpful information.

Shared cache: disabled
Shared cache location: /home/.../.cache/dune/db
Workspace root: /home/...
Auto-detected concurrency: 64
Dune context:
 { name = "default"
 ; kind = "default"
 ; profile = Dev
 ; merlin = true
 ; fdo_target_exe = None
 ; build_dir = In_build_dir "default"
 ; instrument_with = []
 }
Actual targets:
- recursive alias @doc

dune clean and then dune build @doc again works.