Skip to content
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

Add outline / rough draft of new Overview page #519

Merged
merged 24 commits into from Aug 12, 2018
Merged
Show file tree
Hide file tree
Changes from 18 commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
59ea5fc
adding mostly-skeleton overview
mahmoud May 27, 2018
7412ac5
draft talk about frameworks/platforms
mahmoud May 30, 2018
37d6422
expand a little on each section
mahmoud May 31, 2018
3303dbf
address most of @ncoghlan's initial review points at https://github.c…
mahmoud Jun 3, 2018
4a3a1b8
fix @pradyunsg's very valuable copyedits
mahmoud Jun 5, 2018
71b7efd
update title for searchability, add a bit to the binary distribution …
mahmoud Jun 14, 2018
6494e53
flesh out sections, clarify zipapp qualification, add a few links
mahmoud Jul 22, 2018
a4e0ada
expand image sections, add a few related links
mahmoud Jul 22, 2018
3c0a08a
refining a lot of phrasing, expanding on hardware, adding figures
mahmoud Jul 23, 2018
44a27ec
lots of links, and expand on considerations (i think wheels might be …
mahmoud Jul 23, 2018
48e61ed
link freezers
mahmoud Jul 23, 2018
12624cd
more links, slight tweaks to the intro and other language, provide a …
mahmoud Jul 26, 2018
d7d65fd
Merge branch 'master' of https://github.com/pypa/python-packaging-use…
mahmoud Jul 26, 2018
9e53a2f
link to overview from home page
mahmoud Jul 26, 2018
d366f79
various rephrasals and addition of a couple asides
mahmoud Jul 27, 2018
2123ee2
fix typo
mahmoud Jul 27, 2018
a629f96
address most copyediting concerns, tweak a header, and add thea's exp…
mahmoud Jul 29, 2018
8d3aae2
try to tie sdists and wheels more closely together as recommended pra…
mahmoud Jul 29, 2018
acc6807
new -> separate, add a bit more detail
mahmoud Jul 30, 2018
3f2f231
improve frameworks section intro
mahmoud Jul 30, 2018
88a1bc9
add additional encouragement to dual-publish wheels and sdists
mahmoud Aug 10, 2018
ee13f10
adjust heading consistency and add notes for future editors
mahmoud Aug 11, 2018
d1e7111
a few tweaks for flow, plus a favorite quote from Wikipedia for the e…
mahmoud Aug 11, 2018
db86788
add link to jupyterlab writing advice
mahmoud Aug 11, 2018
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
Binary file added source/assets/py_pkg_applications.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/assets/py_pkg_tools_and_libs.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 5 additions & 2 deletions source/index.rst
Expand Up @@ -6,6 +6,7 @@ Python Packaging User Guide
:maxdepth: 2
:hidden:

overview
tutorials/index
guides/index
discussions/index
Expand All @@ -32,8 +33,10 @@ happily accept any :doc:`contributions and feedback <contribute>`. 😊
Get started
===========

Essential tools and concepts for working with the Python packaging ecosystem are
covered in our :doc:`tutorials/index` section:
Thinking about shipping a new Python library or application? Start with :doc:`overview`.

Essential tools and concepts for working within the Python
development ecosystem are covered in our :doc:`tutorials/index` section:

* to learn how to install packages, see the
:doc:`tutorial on installing packages <tutorials/installing-packages>`.
Expand Down