Document the Python APIs in `amaranth.hdl`

[whitequark]

This is a prerequisite for #781, as well as something long overdue in general.

• Start writing reference documentation for the language #1058