🎁 Yii ApiDoc 4.0.0.
A new major release of Yii ApiDoc is here. ✨
This release modernizes ApiDoc for current PHP projects and improves type handling, PHPDoc processing, inheritance support, and generated documentation output.
• PHP 8.2 is now required
• Deprecated code was removed
• nikic/php-parser 5.0 is now required
• phpdocumentor/reflection 7.0 is now required
• phpdocumentor/type-resolver 2.0 is now required
• Added support for intersection and nullable types
• Added support for PHPStan and Psalm type syntax
• Improved type extraction and rendering
• Improved method signatures
• Added support for constants in interfaces and traits
• Added support for inherited descriptions
• Improved inline @see and @link handling
• Added links to built-in PHP functions
• Added a new template for custom projects
• Removed FQSEN support in inline @link tags
Most of this release was handled by Maksim Spirkov, with the new custom project template also based on work by jcherniak and cebe.
❤️ Thank you for supporting our work on Yii.
github.com/yiisoft/yii2-apid…
Pues tienes algunas herramientas para hacerlo un poco más fácil.
Con docstrings CI/CD, por ejemplo.
Puedes usarherramientas como MkDocs, TypeDoc o phpDocumentor para generar docs desde el código y publicarlas automáticamente en cada push.
#TYPO3, #phpDocumentor, #Doctrine, and #Symfony teams will unite for a 2-day sprint in Düsseldorf on 20-21 April 2023 to develop a stable version of the rest parser and renderer.Apply to join the sprint and be a part of the journey!
Find out how to join: hubs.li/Q01JqY900
Join #TYPO3, #phpDocumentor, #Doctrine, and #Symfony Documentation Teams in TYPO3 HQ, Düsseldorf, on April 20-21 to work on a new, stable version of the reST parser and renderer that integrates both forks.Send us a PM if you are interested 💬
Read more:
hubs.li/Q01J9NkJ0
On April 20th and 21st, TYPO3 is organizing a Code Sprint with representatives of the @Symfony, @doctrineproject and @phpDocumentor projects to get RestructuredText support for documenting your projects to the next level.
Do you want to be part? Check the link and register!
My mind is blown with the incredible work @Jaapio and @lina_wolf are doing on @phpDocumentor ! The new feature to render full sets of documentation using Restructured Text is making leaps at the moment! <3
Dokumentasi API pasti ada tool2nya sendiri per bahasa (misal phpDocumentor, javadoc, Doxygen (c/c ), Go Doc, etc). Kalo keseluruhan project (general) pake Markdown bisa (gw pake MkDocs sederhana ringan)
🚨 Are you downloading and running @psalmphp much?
According to @packagist, it has more than 40,000 daily downloads. Yet, @orklah has only ten sponsors.
Are you feeling guilty? Sponsor @orklah now!
↓
github.com/sponsors/orklah
I wonder how many devs outside of the OSS ecosphere are aware how much work it is. I help maintain @phpDocumentor and regularly pause because I need to prevent burning out on it and life and experience other stuff.
I may be overloading @Jaapio with @phpDocumentor pull requests in the past few days ..
I admit that it is nice to fix isolated bugs instead of big architectural overhauls for a moment.
It is therapeutic :)
Conferences inspire me. #SymfonyCon has inspired me to contribute to @phpDocumentor again.
I was looking at our default template and saw so many things to tweak and improve; thus I am adding a sidebar 'On this page' that should help navigate the current page. #wip#php
ALT Screenshot of new feature 'On this page' for phpDocumentor
This is what 12 years of OSS work on @phpDocumentor look like. And let's go for a lot more, and that phpDocumentor becomes a household name in PHP Development for all things related to documentation!
Writing code is like some therapy to me. I forget the sadness of this week. Improving my loved project @phpDocumentor.
Just adding new tests to improve the code. Slower than ever, but it helps a lot.