PEP 1: Replace/Update the "How to teach this" with "Documentation Updates"

I would like to suggest an update to the "How to teach this" section in PEPs to "Documentation Updates".

As part of proposing new features or changes, it would be great if PEP authors also take into consideration of what docs need to be produced/updated.

For example, would the PEP require changes to the how-to doc? Will there be new tutorial section written? What other areas of Python docs need to be updated to accommodate this new change? Are there existing docs that will become outdated and need changing? I think all of these should be taken into consideration when proposing changes so that we can have up to date documentation alongside the changes.

I think the "How to teach this" section meant to address this, but in practise I find the use of this section has been inconsistent, so I recommend making the section be more explicit about documentation artifacts to accompany the feature/change.

I also find some of the "How to teach this" in current PEPs sometimes are sounding can sound hypothetical. I'm seeing phrases like "Teachers could say so and so to students".

Instead of imagining what teachers could say, I think it would be more helpful to come up with concrete plan of what documentation can be produced to assist users in learning and adopting the feature/change.

Bắt đầu bằng cách xác định template hoặc hướng dẫn PEP định nghĩa phần “How to teach this”. Cập nhật phần đó để sử dụng “Documentation Updates” và đưa ra các prompt cụ thể để ghi lại tài liệu cho các tính năng hoặc thay đổi, sau đó kiểm tra việc sử dụng PEP hiện tại để đảm bảo tính nhất quán.