tskit icon indicating copy to clipboard operation
tskit copied to clipboard

Document RateMap etc

Open hyanwong opened this issue 2 years ago • 5 comments

At the moment the documentation is in msprime under its own section within Utilities: Rate Maps. Since it is purely a python thing, I wonder if in tskit it should simply live in the Python API documentation. We already have a utility functions section: we could simply make it "Utility classes and functions" and put some of the explanatory stuff there? Some might want to stay in the msprime docs, I guess. There's quite a lot of material in the current msprime file.

hyanwong avatar Jan 10 '23 16:01 hyanwong

Do we want to make this a blocker for 0.5.4?

jeromekelleher avatar Jan 10 '23 20:01 jeromekelleher

No, I don't think that's necessary if we want to get 0.5.4 out soon. The msprime version will carry on working and is documented there. It will take some thought to get the docs right, so I think it can just be undocumented for the time being.

hyanwong avatar Jan 10 '23 20:01 hyanwong

I think there are good reasons for not documented it yet actually - let's see how the process of cutting it out of msprime goes first and whether we need to make any minor API tweaks first.

jeromekelleher avatar Jan 11 '23 09:01 jeromekelleher

Yes, I agree.

hyanwong avatar Jan 11 '23 09:01 hyanwong