use table.metadata_vector( ) in docs

[petrelharp]

.. when approppriate, for instance changing

max_age = max([ind.metadata["age"] for ind in ts.individuals()])

to

max_age = max(ts.tables.individuals.metadata_vector("age"))

However, let's wait until immutable tables happen, else this will be less efficient, not more efficient due to copying of tables.