Skip to content

doc overhaul step 1: simplify index and group deprecated files#2097

Merged
jaraco merged 8 commits into
pypa:feature/2093-docs-revampfrom
alvyjudy:improve-doc
May 10, 2020
Merged

doc overhaul step 1: simplify index and group deprecated files#2097
jaraco merged 8 commits into
pypa:feature/2093-docs-revampfrom
alvyjudy:improve-doc

Conversation

@alvyjudy

@alvyjudy alvyjudy commented May 10, 2020

Copy link
Copy Markdown
Contributor

This is the first step on #2093 . Quite a few links might be broken for the time being but I would like to make sure I'm on the right track before moving forward

Summary of changes

  1. simplified top index into three entires: user guide, development guide, and deprecated (depth is now 1, before I can clean up the entries for sub index)
  2. renamed doc for python eggs (formats.txt --> python_egg.txt)
  3. move python_eggs, easy_intall, python2to3 docs into dedicated folder (deprecated)
  4. create index inside "deprecated" folder and reference it in the top index

Pull Request Checklist

  • Changes have tests
  • News fragment added in changelog.d.

@alvyjudy

Copy link
Copy Markdown
Contributor Author

If possible, I would like to have this PR merged into a separate branch rather than master because it is an ongoing process and might (and already) break some links until it's completed:)

@jaraco jaraco changed the base branch from master to feature/2093-docs-revamp May 10, 2020 19:41
@jaraco jaraco merged commit d2fe061 into pypa:feature/2093-docs-revamp May 10, 2020
@alvyjudy alvyjudy deleted the improve-doc branch May 10, 2020 20:46
Comment thread docs/index.txt
development
roadmap
Deprecated: Easy Install <easy_install>
history

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Was the removal of the changelog deliberate?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No. The changelog should be retained, and it perhaps should even have a forwarding link so historical links can still reach it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW I've sent a few recovery PRs like #2425

webknjaz added a commit to webknjaz/pypa--setuptools that referenced this pull request Oct 15, 2020
webknjaz added a commit to webknjaz/pypa--setuptools that referenced this pull request Oct 15, 2020
webknjaz added a commit to webknjaz/pypa--setuptools that referenced this pull request Oct 15, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants