2022-09-02, 11:29 AM
I mean, I've found phpdoc a bit underdeveloped in comparison to other documentation software. What'd be the consequences of using doxygen for documenting my plugin?
2022-09-02, 11:29 AM
2022-09-02, 05:49 PM
Feel free to use whichever seems better for custom code.
MyBB uses PHPDoc for general annotations, and to specify types that cannot be used in the code itself for backward compatibility. Modern code would have advanced types annotated using syntax supported by static analysis tools (Psalm, PHPStan); tool-specific tags (that build on the PHPDoc syntax) may also appear there.
To annotate JavaScript, MyBB will likely use JSDoc.
MyBB uses PHPDoc for general annotations, and to specify types that cannot be used in the code itself for backward compatibility. Modern code would have advanced types annotated using syntax supported by static analysis tools (Psalm, PHPStan); tool-specific tags (that build on the PHPDoc syntax) may also appear there.
To annotate JavaScript, MyBB will likely use JSDoc.