switch to n_vertices, n_edges and n_faces for graphs

[mantepse]

This provides aliases n_vertices, n_edges and n_faces, and uses them throughout the docstring EXAMPLES.

The old aliases num_verts,num_edges and num_faces are kept. Also, they are kept in the code base, to avoid touching too many files.

[mantepse]

cf #40887, #40914, #40917

[mantepse]

I did not touch the method names in the graph backends. Should I change them and add aliases for consistency?

[github-actions]

Documentation preview for this PR (built with commit 57156ca; changes) is ready! 🎉
This preview will update shortly after each push to this PR.

[dcoudert]

I did not touch the method names in the graph backends. Should I change them and add aliases for consistency?

Yes, that would be better. Thanks.

[mantepse]

There are about 50 files in total that use num_verts() or num_edges(), many of them are already touched by this PR (which touches about 25 files). If you want to, I can of course change also the usage of num_xxx in the codebase, it is not a big deal, I am happy either way.

[dcoudert]

LGTM.

changes in the codebase can be done in future PR if needed.
Thanks.

[mantepse]

changes in the codebase can be done in future PR if needed. Thanks.

Thank you! Small request: could you (and @fchapoton, and whoever else might be interested) please make a decision. It would be easier for me to do it now (happily in a different PR) than in a few weeks.

[dcoudert]

For the graph module (at least), yes you can do changes in the codebase as well. We have the aliases for compatibility. Thanks.