📚 Official Documentation Hub

“If you didn’t read the docs, you are just guessing.”

::: info Questa pagina centralizza i riferimenti ufficiali per lo sviluppo in Python e C++. L’obiettivo è fornire un accesso rapido alle specifiche dei linguaggi, alle librerie standard e alle convenzioni di codifica adottate a livello internazionale. :::

🐍 Python Ecosystem

Python è celebre per la sua documentazione chiara ed esaustiva. Ecco i pilastri fondamentali:

1. Core Language & Standard Library

• Python 3.x Official Docs: La bibbia completa. Include tutorial, reference del linguaggio e la documentazione di ogni modulo della Standard Library.
• Python Language Reference: Descrive la sintassi e la “core semantics” del linguaggio. Fondamentale per capire come funzionano gli oggetti sotto il cofano.

2. Standards & Style (PEPs)

• PEP 8 - Style Guide for Python Code: Lo standard per scrivere codice leggibile e professionale. Obbligatorio per ogni progetto in questo Wiki.
• PEP Index: L’indice di tutte le Python Enhancement Proposals. Utile per seguire l’evoluzione del linguaggio (es. Type Hinting, Pattern Matching).

3. Package Index & Typing

• PyPI (Python Package Index): Il repository ufficiale dei pacchetti di terze parti.
• Typing Documentation: Guida ufficiale ai Type Hints per lo sviluppo di codice robusto e staticamente analizzabile.

⚙️ C++ Ecosystem (Modern C++)

Il C++ non ha un’unica “casa” come Python, poiché è uno standard ISO gestito da diversi comitati e implementato da diversi compilatori.

1. Technical Reference (The “Bible”)

• Cppreference.com: Il riferimento più completo e aggiornato per C++11, 14, 17, 20 e 23. È lo strumento quotidiano di ogni sviluppatore C++.
• Standard C++ (isocpp.org): Il portale della fondazione che gestisce lo standard. Qui si trovano le news ufficiali e lo stato dei lavori sui nuovi standard.

2. C++ Core Guidelines

• C++ Core Guidelines (GitHub): Curate da Bjarne Stroustrup e Herb Sutter. Sono una serie di regole per scrivere Modern C++ sicuro ed efficiente, evitando i problemi di gestione memoria del passato.

3. Compiler Specifications

• GCC Documentation: Per lo sviluppo su sistemi Linux/GNU.
• Clang Documentation: Eccellente per il feedback sugli errori e il tooling.
• Microsoft MSVC Docs: Indispensabile per lo sviluppo su Windows.

🔗 Python/C++ Integration (Bindings)

Dato che il nostro workflow prevede l’integrazione tra i due linguaggi:

• pybind11 Docs: La libreria standard per creare binding C++ per Python in modo semplice e performante.
• Python C API: Documentazione di basso livello per interfacciarsi direttamente con l’interprete CPython.

🛠️ Sandbox & Testing Tools

Prima di implementare nel progetto locale, usa questi tool per testare snippet di documentazione:

📉 Gerarchia della Verità (Mermaid)

graph TD
    A[Problema Tecnico] --> B{Dove cerco?}
    B --> C[1. Documentazione Ufficiale]
    C --> D[2. C++ Core Guidelines / PEP]
    D --> E[3. GitHub Issues / Source Code]
    E --> F[4. StackOverflow / Blog]
    
    style C fill:#f9f,stroke:#333,stroke-width:4px

Ultimo aggiornamento: {{UPDATE_DATE}} | Tags: #Documentation #Python #CPP #Standard #Programming