Docs/rearranging top level pages #3405
Conversation
Deleted setuptools.rst and redirected incoming links to index page - dropped Features list and Transition Note - moved setup.cfg-only section to setup.cfg page - moved Forum and Bug Tracker to index page - moved manifest note to data files page - moved Configuration API to Deprecated Functionalities?
|
test failure is unrelated, waiting for fix in #3410 |
jacalata
changed the title
|
Yes, thank you very much @jacalata . I have some suggestions: jacalata#1 There is one comment about the redirect setup. I remember reading somewhere that the plugin setuptools is using for the redirects requires the dedtination address to have the |
| @@ -1,5 +1,5 @@ | |||
| "Eggsecutable" Scripts | |||
| ---------------------- | |||
| ================= | |||
There was a problem hiding this comment.
I recall that rst is strict about heading length matches, so will likely warn here (and fail in nitpicky mode). Let's keep the length consistent.
|
|
||
| .. note:: TODO: inserted from "Building and Distributing Packages": is this still true? | ||
|
|
||
| versionadded:: 40.9.0 |
There was a problem hiding this comment.
This line looks like it's meant to be a directive, but there's no ... Is that intentional?
There was a problem hiding this comment.
| versionadded:: 40.9.0 | |
| .. versionadded:: 40.9.0 |
| call is still required even if your configuration resides in ``setup.cfg``/``pyproject.toml``. | ||
|
|
||
|
|
||
| .. note:: TODO: inserted from "Building and Distributing Packages": is this still true? |
There was a problem hiding this comment.
Let's not add TODOs to the docs. Instead, file an issue describing the uncertainty and optionally link that issue in a comment that's not rendered in the output.
There was a problem hiding this comment.
I was hoping to figure this one out before submitting, it seems to mildly conflict with some other text.
| @@ -1,5 +1,5 @@ | |||
| "Eggsecutable" Scripts | |||
| ---------------------- | |||
| ================= | |||
There was a problem hiding this comment.
| ================= | |
| ====================== |
|
@jacalata looks like this PR needs rebasing |
jaraco
force-pushed
the
main
branch
3 times, most recently
from
a85759c to
93ce5a0
Compare
|
This PR seems stale. I'm closing it, but feel free to engage on it again, including requesting to re-open or by re-submitting (presumably after addressing some or all of the concerns above). |
Summary of changes
Deleted setuptools.rst and redirected incoming links to index page
Closes #3400
Pull Request Checklist
changelog.d/.(See documentation for details)