Move stdlib imports to struct scope in hello_world examples

[jinzhongjia]

Summary

Refactor the hello_world examples to move stdlib imports from file-level to struct-level scope. Each struct now independently imports std, eliminating ambiguous reference errors and making each code snippet self-contained for copy-pasting into user projects.

Changes

Code changes (16/hello_world.zig and release/hello_world.zig):

• Moved const std = @import("std") into each struct (One, Two, Three)
• Updated main entry point to use inline @import("std").process.Init type reference
• Refactored Two and Three function signatures to accept init: std.process.Init directly, extracting io inside each function
• Simplified Two example to use unbuffered output (&.{}) for clarity
• Removed unnecessary flush() calls from the unbuffered example
• Improved Chinese comments for accuracy and clarity

Documentation updates (hello-world.md):

• Added explanation of init: std.process.Init parameter and its role
• Clarified that empty buffer &.{} means unbuffered (direct) output
• Updated description to emphasize buffer difference between examples
• Added warning about remembering to flush() when using buffered I/O

Why

Each code snippet in the course is intended to be copyable directly into user projects. Moving imports to struct scope allows independent code samples without file-level import conflicts, and makes the relationship between initialization and I/O operations clearer for learners.

Summary by CodeRabbit

• Documentation
  • Updated the Hello World examples to explain initialization and I/O handling.
  • Clarified unbuffered and buffered output behavior, including the need to flush buffered output.
• Refactor
  • Updated example entry points to pass initialization data through output demonstrations.
  • Improved consistency between buffered and unbuffered writer examples.

[coderabbitai]

📝 Walkthrough

Walkthrough

The hello-world examples now receive std.process.Init, derive I/O from init.io, and create unbuffered or buffered writers. The course documentation explains the new initialization flow, buffer sizes, flushing, and possible data loss.

Changes

Hello-world I/O flow

Layer / File(s)	Summary
Init entry-point wiring course/code/16/hello_world.zig, course/code/release/hello_world.zig	The entry points use std.process.Init and pass the initialization object to Two.main and Three.main.
Unbuffered output handling course/code/16/hello_world.zig, course/code/release/hello_world.zig, course/hello-world.md	Two.main derives I/O from init and creates zero-buffer stdout and stderr writers. The documentation describes this flow.
Buffered output handling course/code/16/hello_world.zig, course/code/release/hello_world.zig, course/hello-world.md	Three.main derives I/O from init and retains separate buffered writers. The documentation specifies 1024-byte buffers and the need to call flush.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Suggested reviewers: jiacai2050, xihale

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the primary refactor: moving standard library imports into struct scope in the hello_world examples.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch hello-world-stdlib-imports

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@course/code/16/hello_world.zig`:
- Around line 3-6: Add independent Zig tests for the One, Two, and Three regions
in both course/code/16/hello_world.zig (lines 3-6) and
course/code/release/hello_world.zig (lines 3-6), producing one test per region
per file. Ensure the tests are discoverable by zig test and exercise each
corresponding entry point independently.

🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a1687247-a38e-48e9-974a-1874f4c3cfe7

📥 Commits

Reviewing files that changed from the base of the PR and between cdb497a and c01c894.

📒 Files selected for processing (3)

• course/code/16/hello_world.zig
• course/code/release/hello_world.zig
• course/hello-world.md