Document Structure and Wishlist

Here is how I envision the typing documentation to be structured:

Tutorials

User-facing basic and advanced introductions to the type system or particular aspects of it. Non-comprehensive.

• Typing tutorial – from the ground up (#891)
• Type stub tutorial – writing a type stub for an existing library, stubgen, contributing to typeshed

Howto Guides

Directory: /guides

User-facing guides to accomplish particular tasks.

• How to add typing to an existing code base
• How to annotate a library (#905)

Reference

Directory: /reference

User-facing, comprehensive reference of the type system.

• Link to the typing module documentation
  • Probably needs a review
• #851
• Type stub syntax and supported constructs
• Type stub style guide

Type System Specification

Directory: /spec

Territory of the Typing Council. Targeted at type checker developers. Here be dragons. 🐉

Links

Top level.

• Links to all typing-related PEPs
• Links to type checkers and other typing tools

Additions, corrections, criticism welcome!

2014-09-02: Updated to reflect the addition of the type system spec. Also, added explanations to the categories.

Xem xét các phần Tutorials, /guides, /reference, /spec và Links ở cấp cao nhất được đề xuất, cùng với các issue được liên kết #891, #905 và #851. Xác định công việc tài liệu nào còn lại và chia danh sách mong muốn rộng này thành các nhiệm vụ cụ thể, có thể thực hiện; việc hoàn thành chưa được định nghĩa cho issue hiện tại.