Documentation for replicate_index

[daikitag]

The replicate_index input in sim_ancestry function https://github.com/tskit-dev/msprime/blob/main/msprime/ancestry.py#L1100 is used repeatedly in various functions, but it is not documented in the docstring or the msprime documentation, and its usage is unclear. It might be better to document it or remove from the input.