While adding documentation to daf_butler for
DM-23174, I found that the documentation page for lsst.daf.butler has a different layout from that recommended by the developer guide or that used in the documentation template. I was able to clean up the command-line script reference (commit moved to this ticket's branch), but the standard module topic makes a distinction between user-facing and developer-facing pages that I cannot reconstruct with the information I have.
Please restructure the documentation page to conform to the developer guide, linking pages from the "Using lsst.dat.butler" and "Contributing" sections as appropriate. This should make the documentation less confusing for new readers.