pratphall icon indicating copy to clipboard operation
pratphall copied to clipboard

Emit php-doc annotations

Open mindplay-dk opened this issue 11 years ago • 0 comments

Compiled output should include php-doc annotations for things like function/method-arguments and property-types, where possible - not all types can be documented using php-doc syntax, since TS has type-features not present in php, and perhaps those type-declarations could be emitted as mixed followed by the actual type-declaration in the comment so it remains visible.

This would bring Pratphall's compiled code one step closer to hand-written quality code - since a lot of php developers may be consuming the compiled php code rather than the TS code, this is important, in the same way that the TS compiler itself strives to output developer-friendly and human-readable JS.

Note that I also recently submitted a similar request to the TypeScript team.

mindplay-dk avatar Aug 27 '13 18:08 mindplay-dk