pypa / pypa/packaging.python.org
Create a new guide for setting up a baseline Python environment
まだ誰も着手していません。
- 主要言語
- Python
- スター
- 1.7k
- フォーク
- 1.7k
- 平均マージ
- 3日 12時間
- マージ済み PR(30日)
- 4
説明
A couple of things I've realised we need to clearly establish for the packaging user guide are:
- Which commands can folks contributing to the packaging guide or working on the PyPI user experience assume will "just work" on an end user's machine?
- How much guidance should the packaging tutorials provide on ensuring a system is in that state, given the wide variety of potential starting states?
Right now, we don't clearly document those environmental assumptions anywhere, which then makes it hard to provide a checklist for people to work through and ensure their environment is set up correctly.
The closest we currently get to this is to include a fairly cursory introduction to virtualenv in the package installation tutorial, and then implicitly assuming that the following is true in the rest of the guide:
- the user is working at a command prompt (whether inside their IDE, or in an actual system shell)
- the command
pythonwill run the desired version of Python - the commands
pip installandpython -m pip installwill be essentially equivalent (aside from the differences when upgrading pip itself on Windows) and install packages into the desired version of Python - any executables installed that way will be executable from that command prompt
- any Python import packages installed that way will be importable from a Python shell started in that environment
Those assumptions are true once you're inside an activated virtual environment, but they're not true in the general case due to the differences between per-user Python installations and system-wide ones, and the differences in cross-platform conventions when it comes to learning how to start Python.
(Issue prompted by https://mail.python.org/pipermail/python-ideas/2017-November/047708.html, #394, and https://github.com/pypa/pip/issues/3164)
Additional related documentation:
- Bootstrapping guide for Linux: https://packaging.python.org/guides/installing-using-linux-tools/
- CPython's getting started guide: https://docs.python.org/3/installing/
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
まず、既存のパッケージングユーザーガイド、パッケージインストールチュートリアル内の virtualenv に関する説明、そしてリンク先の Linux および CPython のインストールガイドを読んでください。サポート対象となるベースラインの前提条件とクロスプラットフォームでのセットアップ手順を定義し、そのうえで、コントリビューターと PyPI ユーザーに対してそれらの前提条件を明示するチェックリストを文書化してください。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- python
- 領域
- documentation
- issue の種類
- ドキュメント
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 活発さ
- 停滞
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 35/100