implements PLN-0092
This commit is contained in:
@@ -214,6 +214,19 @@ Reserved-attribute diagnostics for host-backed asset lowering must also cover:
|
||||
- out-of-range `AssetLowering.param` indexes,
|
||||
- and `AssetLowering` targets whose selected parameter is not statically typed as `Addressable`.
|
||||
|
||||
Documentation attribute diagnostics must cover:
|
||||
|
||||
- unterminated documentation text block syntax,
|
||||
- `Doc` used without the required `markdown` argument,
|
||||
- `Doc` with extra or unknown arguments,
|
||||
- `Doc` with a non-documentation-text-block payload,
|
||||
- duplicate `Doc` on the same declaration,
|
||||
- `Doc` applied to a parameter or other non-documentable surface,
|
||||
- normalized empty or whitespace-only documentation payload,
|
||||
- and rejected aliases or alternate forms such as `text`, positional arguments, `html`, `format`, `Document`, `Documentation`, or `md"""..."""`.
|
||||
|
||||
Diagnostics for duplicate `Doc` attributes must be static semantic diagnostics and should include a related site for the conflicting declaration attribute when available.
|
||||
|
||||
At minimum, host-admission diagnostics must cover missing or malformed host capability metadata and unknown or undeclared capability names.
|
||||
|
||||
Only backend-originated failures that remain source-attributable and user-actionable belong to the PBS-facing diagnostics contract.
|
||||
|
||||
Reference in New Issue
Block a user