dowhy icon indicating copy to clipboard operation
dowhy copied to clipboard

Some [source] links in the docs do not work

Open kbattocchi opened this issue 2 years ago • 2 comments

For example, in the datasets submodule, the [source] links next to at least lalonde_dataset, partially_linear_dataset, and psid_dataset all point to anchors that do not exist on the corresponding datasets source page (and the methods do not appear to be defined within that source at all).

Perhaps relatedly, it looks like some numpy methods are also being re-exported in the datasets module - choice and random, the former of which looks very strange in the documentation here since it says it's new as of version 1.7.0 which makes sense for numpy but not for dowhy; these entries don't have source links at all.

kbattocchi avatar Jul 18 '23 05:07 kbattocchi

Thanks for flagging this @kbattocchi These datasets do exist in datasets.py. I suspect some kind of caching during docs build that is leading to these incorrect results. @bloebp any idea? The numpy.choice mixup is rather strange.

amit-sharma avatar Jul 23 '23 12:07 amit-sharma

Hey, sorry I missed this before.

It is indeed strange and I don't see an obvious reason for these things. In 0.10, the source links are working, but not on main.

When building the documentation there is, however, a long list of issues and warnings, maybe it is time to go through this one by one. I can give it a shot, but can't promise when (it will definitely take some time to fix all of it).

bloebp avatar Aug 14 '23 14:08 bloebp