# Dune build @doc producing empty index

**URL:** <https://discuss.ocaml.org/t/dune-build-doc-producing-empty-index/6784>\
**Category:** Ecosystem\
**Tags:** dune\
**Created:** [November 16, 2020, 9:59pm UTC](https://discuss.ocaml.org/t/dune-build-doc-producing-empty-index/6784 "2020-11-16T21:59:14Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![yawaramin](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/yawaramin/32/3384_2.png) [@yawaramin](https://discuss.ocaml.org/u/yawaramin)\
**Post date:** [November 16, 2020, 9:59pm UTC](https://discuss.ocaml.org/t/dune-build-doc-producing-empty-index/6784/1 "2020-11-16T21:59:14Z")

</div>

EDIT: solved it right after posting. I forgot the `(public_name ...)` field in the `dune` file.

Hi, when I run `dune build @doc` locally I get a empty index, as can be seen here: [https://yawaramin.github.io/ocaml-decimal/api/decimal/index.html](https://yawaramin.github.io/ocaml-decimal/api/decimal/index.html)

The package `decimal` has the following layout:

```auto
decimal.opam
dune-project
  (lang dune 2.7)
  ...
  (package
    (name decimal)
    ...)
lib/
  calc.ml
  decimal.ml
  decimal.mli
  dune
    (library
      (name decimal)
      (libraries str zarith))

```

Can anyone say what might be going wrong here?

---

<div class="post-metadata">

**Author:** ![CraigFe](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/craigfe/32/1989_2.png) [@CraigFe](https://discuss.ocaml.org/u/CraigFe)\
**Post date:** [November 16, 2020, 10:04pm UTC](https://discuss.ocaml.org/t/dune-build-doc-producing-empty-index/6784/2 "2020-11-16T22:04:53Z")

</div>

Your issue is probably the lack of a `(public_name ...)` field in the library definition – this one catches me out from time to time too.

(edit: oops; I see in your edit that you already found a solution 🙃)

---

<div class="post-metadata">

**Author:** ![yawaramin](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/yawaramin/32/3384_2.png) [@yawaramin](https://discuss.ocaml.org/u/yawaramin)\
**Post date:** [November 16, 2020, 11:32pm UTC](https://discuss.ocaml.org/t/dune-build-doc-producing-empty-index/6784/3 "2020-11-16T23:32:52Z")

</div>

Thanks in any case! Felt like this deserved to be marked as solved, so your answer was apropos!

---

<div class="post-metadata">

**Author:** ![kit-ty-kate](https://sea2.discourse-cdn.com/flex020/user_avatar/discuss.ocaml.org/kit-ty-kate/32/5953_2.png) [@kit-ty-kate](https://discuss.ocaml.org/u/kit-ty-kate)\
**Post date:** [November 18, 2020, 5:21am UTC](https://discuss.ocaml.org/t/dune-build-doc-producing-empty-index/6784/4 "2020-11-18T05:21:28Z")

</div>

It’s a known flaw in dune. If someone could upvote or fix it this would save many hours of debug for many many people: [https://github.com/ocaml/dune/issues/2882](https://github.com/ocaml/dune/issues/2882)

It’s on my endless TODO-list but i don’t have time to do it myself.