New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Overhaul of Doc/library/__main__.rst #88660
Comments
I made a proposal on discourse to redraft Doc/library/main.rst as it is currently quite terse and there have been a series of bpo's asking for more. See my discourse post: https://discuss.python.org/t/proposed-overhaul-of-main-py-documentation-doc-library-main-rst/9344 I propose a broad overhaul of Doc/library/main.rst to address these The new Doc/library/main.rst should have a new synopsis of, “CLIs, Additionally, the new docs should have the following distinct sections:
If there is interest, I would be happy to open uptake this work on as soon as there is Anyway, I have a first draft ready. I'm sure there will be plenty of feedback, so let it rip! I will open a GitHub PR and attach it to this bpo in just a moment. |
Hi Jack, I'm not sure it's necessary to create a new issue for "Overhaul of Doc/library/main.rst" when we already have bpo-39452 to "Improve the __main__ module documentation" and bpo-24632 to "Improve documentation about __main__.py". What we really need to is close all but one of them as duplicates and consolidate the work. Also, the people who are on the nosy lists of the previous issues will not necessarily see the discussion you opened on this one if you won't alert them to it. Have you looked at the open PR on bpo-39452? I think there may be some overlap with what you did here (but I didn't check in any detail). |
@iritkatriel, ok, I will close this issue, close PR26867, and move the work I have over there. I probably can merge in and build upon the work from the contributor on bpo-39452. |
That's a good plan! |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
bugs.python.org fields:
The text was updated successfully, but these errors were encountered: