公式ドキュメントよりも優れたPythonの推奨リファレンスマニュアルはありますか？私は経験豊富なプログラマー（PHP、C＃、javascript、そして最近ではいくつかのC）であり、PythonマニュアルはPHPマニュアルとMSDNに比べてかなり不足しています。特に、公式ドキュメントでは、無効なものを渡した場合にどのようなエラーが発生する可能性があるかを教えてくれないようです。また、モジュール内を移動する方法がないようです。
osモジュールを例にとってみましょう。そのページで呼び出すことができる定数またはメソッドのリストがないため、「stat(」が見つかるまでCtrl+fを押す必要があります。次に、それを見つけたら、stat存在しないディレクトリで呼び出した場合に何が期待できるかを教えてくれないので、ターミナルで試して何が起こるかを確認する必要があります。
これは非常に非効率的なようです…Pythonプログラマーはこれにどのように対処しますか？
実際には、動作を確認するためのクイックテストプログラムを作成するか、ソースコードを読み取ります。Python標準ライブラリコードの多くはかなり明確に記述されており、実際には自己文書化されているため、何かがどのように機能するかについての詳細を知る必要がある場合は、それを参照するのが標準的な方法です。
1つの例外：モジュール内の多くのような低レベルのシステム関数ではos、関数は基盤となるプラットフォームのCの名前に直接マップされます。したがって、Pythonの動作について知る必要がある場合は、プラットフォームのネイティブC呼び出しstatのリファレンスドキュメントを調べてください。statこのような場合、Pythonライブラリのドキュメントでは、関数の基本的な目的と、関数がCに相当するものとどのように異なるかについてのみ説明していることがよくあります。
私はあなたと同じようにPythonのドキュメントに対して同じ気持ちを持っていたとは思いませんが、Pythonの一部がどのように機能するかをよりよく理解するために、時々邪魔にならないようにする必要がありました。それがほとんどの言語ですが。Pythonはすばやく簡単に習得できる言語であり、ドキュメントの作成にかかる時間が短縮され、プログラミングにかかる時間が長くなります。また、PythonのユーザーベースはPHPほど大きくありません。PHPには、特定の機能の例と詳細を毎日提供する人々がいます。
Pythonのもう1つの優れた点は、テストするためのインタラクティブなシェルです。プログラミングについての私の考えだけで、それを実行してから見ることで、より多くを学ぶことができます。したがって、コンパイルをドラッグする必要のないものをテストすることに興味がある場合は、インタープリターで簡単なスクリプトを作成するだけです。インタプリタには参照ツールもあります。例dir(<identifier>)とhelp(<identifier>)モジュール、クラスまたは関数のニーズ。
私の好きな言語を十分に守るために、pyDocはPythonから必要なものを取得するのに役立つ少し便利なツールです。
pydocは、Pythonドキュメントの表示と生成に使用できるPythonに付属のツールです。