Documentation on "Generation of trees" is incomplete

[maxale]

Steps To Reproduce

There exist at least 3 methods of trees generation in Sage:

• via sage.graphs.trees.TreeIterator()
• via graphs.trees()
• via graphs.nauty_gentreeg()

Expected Behavior

Documentation at https://doc.sagemath.org/html/en/reference/graphs/sage/graphs/trees.html should mention all available methods, and possibly explain differences between them.

Actual Behavior

Only the first method is described.

Additional Information

No response

Environment

• OS: N/A
• Sage Version: 10.6.beta1

Checklist

• I have searched the existing issues for a bug report that matches the one I want to file, without success.
• I have read the documentation and troubleshoot guide

[PrashantChoudhary13579]

Hello sir,
Please assign this task to me as i want to do something for this organisation.

[DaveWitteMorris]

See "Various families of graphs" for the documentation of graphs.nauty_gentreeg and graphs.trees. It does seem like a good idea to mention these under "Generation of trees"

[PrashantChoudhary13579]

OK sir,
Thank you sir for providing the information. I will go through them.

[DaveWitteMorris]

PS I think you should be able to assign yourself to this task. Are you unable to do that from some reason? (Also, being assigned to a task is not required in order to work on it. However, it's a good idea because it can avoid wasted effort by dissuading anyone else from working on it at the same time.)

[maxale]

It does seem like a good idea to mention these under "Generation of trees"

I consider "Generation of trees" as an entry point to the subject, and this is where anyone searching for how to generate trees in Sage will likely end up. So, either it should be comprehensive about various ways of generating trees in Sage, or should be renamed to something more specific like "Generation of trees with TreeIterator" or alike. I like the former option better.