Maybe hide some implementation details?

[mnishiguchi]

It is a matter of design decision. So it is just an idea.

Currently the library exposes all the implementation details. I have a feeling that what users want is the top-level module and its functions. If we hide all the potentially-private modules, the documentation could be simpler. Then we can explain about each of the top-level functions in their @doc.

In other words, do the users need to know about REnum.Native, REnum.Ruby, etc?

[tashirosota]

Nice idea！I agree it.

When @moduledoc false, the link is broken in top level module REnum

It's hard if writes all docs to top level module...
I don't know other way.
Do you know any good way?

[mnishiguchi]

I had the same issue before. We cannot use the docs of hidden modules. Let me find some info...

[mnishiguchi]

Hmmm I cannot find a way to hide modules nicely so far...

I guess after all it is GOOD AS IS. At first I just thought the docs could be compact somehow.
The benefit of the meta programming is huge here and all looks cleanly organized 👍

[tashirosota]

@mnishiguchi
Thank you for looking for another way.
If possible, I would like to display only top level modules, so if I find a good way to do it in the future, I would love to do so!
Leave this issue as it is!