(This is a very small and subtle suggestion.)
In the dev documention, in the “Introductory Overview of PyMC”,
the term “chain” is introduced without being defined.
It appears twice in the introductory text (the Abstract and Introduction) sections, but that is in the general sense of Markov chains. I am referring to the technical or API sense in which it appears in subsequent text, for example, in the output examples
Sequential sampling (2 chains in 1 job)
Sampling 2 chains for 1_000 tune and 1_000 draw iterations (2_000 + 2_000 draws total) took 5 seconds.
and in the text, “Notice that
sample generated a set of parallel chains, depending on how many compute cores are on your machine.”
In those places, one gets the impression that a
chain is a software entity, specific to PyMC, i.e., a data type or structure (probably representing a realization of a Markov process etc.). It would be helpful if the text clarified that, the first time the term appears in that sense. (Is it, in fact, a PyMC data type, for example? I am sure I will learn as I go on, but I’m trying to provide “first impression” feedback on any rough edges I find in the docs before, before I become inured to them : )
I hope you find this feedback helpful. Thank you for considering it.