Skip to content

[Feature] Traduzione completa Iterators (Issue #6)#7

Merged
AndreaBozzo merged 2 commits intomainfrom
traduzione/std-iterators
Dec 2, 2025
Merged

[Feature] Traduzione completa Iterators (Issue #6)#7
AndreaBozzo merged 2 commits intomainfrom
traduzione/std-iterators

Conversation

@AndreaBozzo
Copy link
Contributor

Descrizione

Traduzione completa della documentazione std::iter con creazione di nuovo file dedicato.

Contenuto

  • Nuovo file: docs/std/iterators/index.md (~1625 righe)
  • Trait Iterator e IntoIterator
  • 40+ metodi (adapter e consumer)
  • Iteratori infiniti e trait speciali
  • Implementazione custom
  • Pattern e best practice
  • Esempi pratici complessi

Modifiche

  • Creato docs/std/iterators/index.md
  • Aggiornato mkdocs.yml (navigazione)
  • Aggiornato docs/std/index.md (sezioni completate)
  • Aggiornato docs/std/collections/index.md (cross-link)
  • Aggiornato README.md (checklist)
  • Fix dev-setup scripts (rimosso npm global install)
  • Aggiornato .pre-commit-config.yaml (markdownlint opzionale)

Checklist

  • Consultato glossario per terminologia
  • Testato build locale con mkdocs serve
  • Verificati tutti i link
  • Seguito linee guida stilistiche
  • Esempi codice in inglese
  • Aggiunto link documentazione originale

Link

- Creato docs/std/iterators/index.md (~1625 righe)
  - Trait Iterator e IntoIterator
  - 40+ metodi (adapter e consumer)
  - Iteratori infiniti e trait speciali
  - Implementazione custom
  - Pattern e best practice
  - Esempi pratici complessi

- Aggiornato mkdocs.yml (navigazione)
- Aggiornato docs/std/index.md (sezioni completate)
- Aggiornato docs/std/collections/index.md (cross-link)
- Aggiornato README.md (checklist)

- Fix dev-setup scripts (rimosso npm global install)
- Aggiornato .pre-commit-config.yaml (codespell + markdownlint optional)
@AndreaBozzo AndreaBozzo requested a review from Copilot December 2, 2025 11:38
@AndreaBozzo AndreaBozzo linked an issue Dec 2, 2025 that may be closed by this pull request
@AndreaBozzo AndreaBozzo self-assigned this Dec 2, 2025
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a comprehensive Italian translation of Rust's iterator documentation, introducing a new 1638-line file covering the Iterator and IntoIterator traits, along with 40+ iterator methods, adapters, and consumers. The translation follows the project's established conventions with Italian prose and English code examples.

Key Changes:

  • New comprehensive iterator documentation with detailed examples of lazy evaluation, the three forms of iteration (iter/iter_mut/into_iter), and iterator adapters/consumers
  • Updated navigation structure in mkdocs.yml and docs/std/index.md to include the new iterators section
  • Improved dev-setup scripts to use npx instead of global npm install for markdownlint
  • Made markdownlint pre-commit hook optional

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
docs/std/iterators/index.md New comprehensive iterator documentation in Italian with code examples covering traits, methods, patterns, and best practices
mkdocs.yml Added Iterators section to navigation under Standard Library
docs/std/index.md Moved Iterators from "Pianificate" to "Completate" section
dev-setup/setup-dev.sh Changed to use npx for markdownlint instead of global npm install
dev-setup/setup-dev.bat Changed to use npx for markdownlint instead of global npm install
dev-setup/README.md Updated documentation to reflect npx usage for markdownlint
README.md Marked Iterators as completed in the project checklist
.pre-commit-config.yaml Commented out markdownlint hook (made optional) and added "distintive" to codespell ignore list
.markdownlint.json Reformatted allowed_elements array for MD033 rule

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…` in esempi di somma e riduzione, migliorando la chiarezza e la correttezza del codice.
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

}

// Ora possiamo usare Countdown in un for loop
for i in Countdown { count: 5 } {
Copy link

Copilot AI Dec 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Syntax error in struct instantiation. In Rust, struct literals use : to separate field names and values, not . The correct syntax should be Countdown { count: 5 } (with a : instead of a space).

Copilot uses AI. Check for mistakes.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La sintassi for i in Countdown { count: 5 } { ... } è perfettamente legale in Rust. Le parentesi graffe della struct e quelle del blocco for sono distinte correttamente dal parser, ma devo controllarmele sempre io ste cose cosa ti pago a fare

@AndreaBozzo
Copy link
Contributor Author

per CC: @LorenzoTettamanti , mergio stasera o domani

@LorenzoTettamanti
Copy link
Contributor

@AndreaBozzo perfetto, grazie! A breve finisco anche la mia (#5). In quest'ultimo periodo sono un po' preso

@AndreaBozzo AndreaBozzo merged commit ebe02de into main Dec 2, 2025
8 checks passed
@AndreaBozzo AndreaBozzo deleted the traduzione/std-iterators branch December 2, 2025 13:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature] Iterators

2 participants