Tracking - Documentation - Python section in nixpkgs manual.

[alejandrosame]

Project description

This tracking issue exists to help analyze the Python section in the nixpkgs manual.

Python section issues

Reported problems with the nixpkgs manual Python section.

• Doc: example dont work in 15.17.1.4. Including a derivation using callPackage #72167
• Documentation bug or incomplete check for python shellHook development mode #66460

Missing Python reference documentation

Python related Nix APIs, use cases, etc., possibly lacking reference documentation.
These are to be checked, but can be useful for other types of documentation.

• python-language-server packaging issues #229337
• Add documentation for writePython3 and friends #89759
• Improve documentation around building python packages with poetry #78442
• PYTHONPATH is not available in environment when using python.buildEnv or python.withPackages #61144
• Unable to override "disabled" attribute with overridePythonAttrs #48663
• Guidance for packaging packages providing Python bindings #40835
• Python: wrapPythonPrograms should not add (propagated) build inputs to wrappers #24128 (comment)
• Python: wrapped python packages don't propagate their PYTHONPATH #23676
• Python packages installing absolute paths to $out/lib/python-xxx/site-packages #23438 (comment)
• python: can not use imperatively installed packages as libraries #10597
• Python ecosystem improvements (placeholder issue) #1819

Issues created as part of Documentation Project 2023 efforts

• Documentation: Update bespoke markdown syntax reference #246357
• nixpkgs manual: Python chapter structural problems #246234
• nixpkgs manual: python section: interface reference coverage  #250376
• nixpkgs manual: python section: comments on interpreters section #251959
• nixpkgs manual: python section: comments on building packages section #251963
• nixpkgs manual: python section: comments on setup hooks section #251965
• nixpkgs manual: python section: lack of useful hyperlinks #251964
• nixpkgs manual: python section: comments on attributes section #251962

Context: Call for Documentation Project 2023 positions.