You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Feature Request: Global edit_on_github_branch setting for all versions #6297
"On GitHub -> Edit" option to only allow edit on master branch of the repo. We attempted this at astropy/astropy#9379 but realized that it would not retroactively apply to all the released versions we ever pushed out or archived.
The reason we want this is to prevent contributor to accidentally open a pull request against stale/release branches. We only accept pull request against the master branch.
Is there a global setting that we can use in, say, .readthedocs.yml to control this? Thank you!
Actual Result
Contributor clicked on the "Edit" link and accidentally opened a pull request against the wrong branch in the source code repository.
Sorry, don't think this isn't possible without rebuilding all versions.
Don't think we have a pattern to edit old versions without rebuilding. You could branch those versions and add the change and push that new version to rtd and add a redirect from the old version to the fixed version.
Is there a global setting that we can use in, say, .readthedocs.yml to control this?
We don't plan to add global setting on the configuration file, only per version settings.
The link live however in the same dropdown menu the list of versions
That link is generated dynamically yes, but we always display the link from the same version the user is reading, we are working in making that configurable (but only something like display or not that link, no to change the content).
You can patch that menu using a custom js file, but that requires re building the versions too.
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.
We will exposing the whole data that Read the Docs uses to build the flyout via a javascript event that users can subscript to and render the flyout exactly how they want: adding more section, removing sections, showing the language selector somewhere else, etc.
Activity
stsewd commentedon Oct 16, 2019
Sorry, don't think this isn't possible without rebuilding all versions.
Don't think we have a pattern to edit old versions without rebuilding. You could branch those versions and add the change and push that new version to rtd and add a redirect from the old version to the fixed version.
We don't plan to add global setting on the configuration file, only per version settings.
pllim commentedon Oct 16, 2019
Thanks for the quick reply. We'll think of other ways on our end.
bsipocz commentedon Oct 16, 2019
@stsewd - The link live however in the same dropdown menu the list of versions, too. Isn't there a way to patch that box in the deployed versions?
stsewd commentedon Oct 16, 2019
That link is generated dynamically yes, but we always display the link from the same version the user is reading, we are working in making that configurable (but only something like display or not that link, no to change the content).
You can patch that menu using a custom js file, but that requires re building the versions too.
bsipocz commentedon Oct 16, 2019
Being able to not display that link would solve all our headaches, so I'm extremely happy to hear that you're working on making that possible.
stale commentedon Nov 30, 2019
This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.
stsewd commentedon Dec 2, 2019
@pllim did you reopen the issue to still request the global
edit_on_github_branchsetting? Or is there something else?pllim commentedon Dec 2, 2019
Yes, I did re-open it due to #6297 (comment) . Sorry for the confusion!
stsewd commentedon Dec 2, 2019
@pllim so is the same requests as described in the description? or the one from the comment? (being able to not display the link)
pllim commentedon Dec 2, 2019
Being able to not display the link would be a workaround solution for lacking a global setting, which I will accept. Does that make sense?
humitos commentedon Sep 15, 2023
Thanks all for your feedback here.
We are working a new project called addons which is currently in beta (read more in our blog post at https://blog.readthedocs.com/addons-flyout-menu-beta/) which includes a new completely redesign of the flyout. We are considering these type of configuration there and we have an issue for this: readthedocs/addons#51 and readthedocs/addons#13
We will exposing the whole data that Read the Docs uses to build the flyout via a javascript event that users can subscript to and render the flyout exactly how they want: adding more section, removing sections, showing the language selector somewhere else, etc.
Please subscribe there for updates.