Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation: Amélioration de la PHPDoc de la classe ajax selon les nouveaux standards #3011

Open
wants to merge 1 commit into
base: alpha
Choose a base branch
from

Conversation

kwizer15
Copy link
Contributor

@kwizer15 kwizer15 commented Jan 12, 2025

Description

Cette PR propose une amélioration de la documentation PHPDoc de la classe ajax.class.php pour la rendre conforme aux nouveaux standards de documentation établis pour le core.

Les principaux changements incluent :

  • Passage de la documentation en anglais
  • Simplification des descriptions pour une meilleure lisibilité
  • Suppression des TODOs et des notes d'évolution
  • Ajout des tags manquants (@deprecated, @return)
  • Amélioration des références croisées (@see)
  • Documentation plus précise des paramètres et types de retour

Cette mise à jour s'inscrit dans une démarche globale d'amélioration de la documentation du core.

Post community : https://community.jeedom.com/t/aide-phpdoc-du-core/63287/12
Standards de la phpdoc en cours de rédaction : https://github.com/kwizer15/jeedom-documentations/blob/feat/doc-phpdoc/fr_FR/dev/php/phpdoc.md

Suggested changelog entry

Amélioration de la PHPDoc de la classe ajax selon les nouveaux standards de documentation du core.

Related issues/external references

Lié à #3004 #3010

Types of changes

  • Bug fix
  • New feature
  • Breaking change
    • This change is only breaking for integrators, not for external standards or end-users.
  • Documentation improvement

PR checklist

  • I have checked there is no other PR open for the same change.
  • I have read the contribution guidelines.
  • I grant the project the right to include and distribute the code under the GNU.
  • I have added tests to cover my changes.
  • I have verified that the code complies with the projects coding standards.
  • [Required for new sniffs] I have added MD documentation for the sniff.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant