Opened 6 years ago

Last modified 6 years ago

#17593 new enhancement

Improve documentation for creating PermutationGroupElement. — at Initial Version

Reported by: nthiery Owned by:
Priority: major Milestone: sage-6.5
Component: group theory Keywords:
Cc: ncohen Merged in:
Authors: Reviewers:
Report Upstream: N/A Work issues:
Branch: Commit:
Dependencies: Stopgaps:

Status badges

Description

I had a student today that had a bit of difficulty finding the documentation explaining how to create a permutation group element.

This is actualy well documented, but in the __init__ method of PermutationGroupElement?. Because of this, when typing PermutationGroupElement? the user first gets the documentation of the class itself (which is currently not particularly useful), and only after the useful documentation of the __init__. This also means that the useful doc does not appear in the html documentation.

What about moving the documentation on how to create permutation group elements to the class docstring?

Thanks!

Change History (0)

Note: See TracTickets for help on using tickets.