Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Ch 30 / 20.python.list-reference.ipynb — Python side complete, C++ bridge missing

Đang mở
  • Có gì không ổn?
#76 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
68/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
cpp, jupyter-notebook, python
Lĩnh vực
content, documentation

Hướng nghiên cứu

Mở 30.pointers-and-memory-management/20.python.list-reference.ipynb và chạy các ví dụ Python hiện có, tập trung vào các lời nhắc dự đoán trước khi chạy trong các ô 12 và 17, cùng bài tập trong ô 24. Thêm phần kết nối C++ xung quanh ô 22, bao gồm các ví dụ raw-pointer và vector được yêu cầu, bảng phép tương tự, thuật ngữ copy và một bài tập dự đoán cuối cùng. Công việc được xem là hoàn tất khi notebook liên kết các quan sát trong Python với cả hai trường hợp C++ trước bài tập hiện có.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement freshman-audience

The notebook 30.pointers-and-memory-management/20.python.list-reference.ipynb sets up an excellent pedagogical hook: the Python [one_row] * n_row aliasing pattern (where one inner list gets referenced 10 times) is exactly the right entry point for introducing reference semantics in a language students already know. The predict-before-run prompts in cells 12 and 17 ("What do you think happened?" / "Why the result is different this time?") are pedagogically strong.

However, the notebook stops at the exercise prompt (cell 24):

"Write two C/C++ programs that respectively regenerate python results above."

without providing the C++ side of the bridge. Students are left to make the cross-language connection on their own — exactly the connection the notebook's title (python.list-reference) and structure promise to deliver.

Suggested addition (~3-4 hours of work)

Add a new section after the Python observations (around cell 22, before the exercise) that:

  1. Writes the equivalent C++ programs — one with raw int** showing the aliasing bug parallel; one with std::vector<std::vector<double>> showing the safe modern equivalent.

  2. Translates the is / id() mental model to C++ — Python a is b corresponds to C++ &a == &b for the aliasing case. Show this with cout << &matrix[0] << " == " << &matrix[1] << '\n'; parallel.

  3. Names the analogy explicitly with a side-by-side table:

    Python C/C++ What it means
    b = a (list) int *b = a; Both point to same memory
    b = a.copy() std::vector<int> b = a; Deep copy
    a is b &a[0] == &b[0] Same memory?

  4. Connects to "shallow vs deep copy" as a named concept that bridges both languages.

  5. Closes with a "predict before run" mission parallel to the Python exercises.

Why this matters

This notebook contains the single most pedagogically unique idea in the repo — using Python as the anchor for C++ pointer semantics. As-is, it's a sketch of the bridge rather than the bridge itself. Completing it would make this the most powerful piece of the Ch 30 supplement-for-freshmen role discussed in 2026-05-20 session evaluation.

Context

Tagged freshman-audience because completing this bridge is specifically what makes the chapter useful for post-Python freshmen (rather than the graduate audience the chapter was originally written for).

Ngôn ngữ chính
Jupyter Notebook
Star
3
Fork
1
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của kangwonlee/2018pycpp

Tất cả issue của kangwonlee/2018pycpp

Issue tương tự

Thêm issue về Content

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.