[AI] docs: Inline script metadata

[rubenfiszel]

/ai add docs for recently added inline script-metadata. Also add link to "select-python-version" and update "select-python-version" as well with version specifiers like py: >=3.12,. Request made by @pyranota

[claude]

Claude finished @rubenfiszel's task —— View job • claude/issue-969-20250529_184546 • [Create PR ➔](https://github.com/windmill-labs/windmilldocs/compare/main...claude/issue-969-20250529_184546?quick_pull=1&title=Issue%20%23969%3A%20Changes%20from%20Claude&body=This%20PR%20addresses%20issue%20%23969%0A%0AGenerated%20with%20%5BClaude%20Code%5D(https%3A%2F%2Fclaude.ai%2Fcode)

---

Successfully completed inline script metadata documentation

Todo List:

• Analyze repository structure and find existing documentation
• Locate "select-python-version" documentation
• Research inline script metadata feature
• Add documentation for inline script metadata
• Update select-python-version documentation with version specifiers
• Add cross-links between related documents
• Commit changes and create PR

Summary of Changes

I've successfully added comprehensive documentation for inline script metadata and updated Python version specifiers as requested:

1. Added Inline Script Metadata Documentation

• Created new section in flow editor components (/docs/flows/3_editor_components.mdx)
• Documented key features: diff toggle, backend schema validation, enhanced dependency management
• Included local development workflow with CLI commands (wmill flow generate-locks)
• Added proper cross-references to related documentation

2. Updated Python Version Documentation

• Enhanced Python quickstart (/docs/getting_started/0_scripts_quickstart/2_python_quickstart/index.mdx) with version specifiers
• Added examples: py: >=3.12, py: >=3.11,<3.14, py: ==3.12
• Updated dependencies documentation (/docs/advanced/15_dependencies_in_python/index.mdx) to reference version specifiers

3. Cross-References Added

• Links between inline script metadata and Python version selection
• Updated DocCard descriptions to include version specifiers
• Proper navigation between related features

Pull Request Created

🔗 PR #970: Add inline script metadata documentation and update Python version specifiers

All changes follow the repository's MDX formatting standards, use proper DocCard components, and adhere to the CLAUDE.md guidelines (sentence case, no unnecessary bold formatting, etc.).

---

[pyranota]

/ai inline script metadata is related to python. It implements PEP-723. You should say that windmill is now compatible with that format and show example. Mention that requires-python = "==3.12." has shortcut and crosslink to "select-python-version" where you have example of "#py: ==3.12."

[claude]

Claude finished @pyranota's task —— View job • claude/issue-969-20250529_185818 • [Create PR ➔](https://github.com/windmill-labs/windmilldocs/compare/main...claude/issue-969-20250529_185818?quick_pull=1&title=Issue%20%23969%3A%20Changes%20from%20Claude&body=This%20PR%20addresses%20issue%20%23969%0A%0AGenerated%20with%20%5BClaude%20Code%5D(https%3A%2F%2Fclaude.ai%2Fcode)

---

Successfully enhanced PEP-723 inline script metadata documentation

Todo List

• Read current inline script metadata documentation
• Update documentation to mention PEP-723 compatibility
• Add PEP-723 format examples
• Add requires-python shortcut information with cross-link
• Update select-python-version documentation with shortcut examples
• Commit changes to branch

Summary of Changes

I've successfully enhanced the Windmill documentation to properly explain PEP-723 inline script metadata support as requested:

1. Enhanced Flow Editor Components Documentation

• Added comprehensive "Inline script metadata" section to /docs/flows/3_editor_components.mdx
• Documented Windmill's PEP-723 compatibility with the official Python packaging standard
• Included complete PEP-723 format examples with # /// script blocks
• Added Python version shortcut examples (#py: >=3.12)
• Provided proper cross-references to Python version selection documentation

2. Updated Python Quickstart Guide

• Enhanced /docs/getting_started/0_scripts_quickstart/2_python_quickstart/index.mdx
• Added "Python version specifiers" subsection with advanced examples
• Showed PEP 440 syntax usage: #py: >=3.12, #py: ==3.12.*, #py: >=3.11,<3.14
• Referenced PEP 440 standard for version specifiers
• Explained the shortcut equivalent to requires-python field

3. Enhanced Dependencies Documentation

• Added dedicated PEP-723 section to /docs/advanced/15_dependencies_in_python/index.mdx
• Documented both standard PEP-723 format and convenient shortcuts
• Included comprehensive examples showing dependencies and version requirements
• Added proper cross-links between inline script metadata and Python version docs

Key Features Documented

• PEP-723 Standard Compliance: Documented that Windmill implements the official Python packaging standard for inline script metadata
• Standard Format Support: Full # /// script blocks with requires-python and dependencies fields
• Convenient Shortcuts: #py: annotations as shortcut for requires-python = "==3.12.*"
• Version Specifiers: Support for PEP 440 syntax like >=3.12, ==3.12.*, >=3.11,<3.14
• Cross-References: Proper linking between related documentation sections

Pull Request Created

🔗 PR #971: Add PEP-723 inline script metadata documentation

All changes follow the repository's MDX formatting standards, use proper DocCard components, and adhere to the CLAUDE.md guidelines (sentence case, appropriate cross-linking, etc.).

---

• claude/issue-969-20250529_185818