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

docs/update-api-doc-for-patch-comment-route #195

Open
4 tasks
Tracked by #151
benoit-bremaud opened this issue Jul 20, 2024 · 0 comments
Open
4 tasks
Tracked by #151

docs/update-api-doc-for-patch-comment-route #195

benoit-bremaud opened this issue Jul 20, 2024 · 0 comments
Assignees
Labels
api Related to API documentation and implementation backend Label to indicate the backend team documentation Improvements or additions to documentation

Comments

@benoit-bremaud
Copy link
Owner

benoit-bremaud commented Jul 20, 2024

Summary

Mettre à jour la documentation de l'API pour inclure la nouvelle route PATCH /comments/:id. Cette issue est liée à l'implémentation de la nouvelle route permettant de mettre à jour partiellement un commentaire spécifique par son ID.

Context

Pour s'assurer que les utilisateurs et les développeurs comprennent comment utiliser la nouvelle route PATCH /comments/:id, il est essentiel de mettre à jour la documentation de l'API. Cela inclut la description de la route, les paramètres, les réponses attendues, et des exemples d'utilisation.

Objectives

  • Mettre à jour la documentation de l'API pour inclure la nouvelle route PATCH /comments/:id.
  • Décrire les paramètres requis et optionnels pour cette route.
  • Inclure les réponses attendues, y compris les cas de succès et d'erreur.
  • Fournir des exemples d'utilisation de la route.

Acceptance Criteria

  • La documentation de l'API doit inclure une section détaillée pour la route PATCH /comments/:id.
  • La documentation doit décrire les paramètres requis (id) et les en-têtes d'authentification nécessaires.
  • La documentation doit inclure des exemples de requêtes et de réponses pour les cas de succès et d'erreur.
  • La documentation doit être claire et facile à comprendre pour les développeurs.

Tasks

  • Ajouter une section pour la route PATCH /comments/:id dans la documentation de l'API.
  • Décrire les paramètres requis pour la route.
  • Inclure des exemples de requêtes et de réponses pour les cas de succès et d'erreur.
  • Assurer que la documentation est cohérente avec le reste de la documentation de l'API.

Resources

UML Diagrams References

  • Sequence Diagram : Pour visualiser le flux d'opérations lors de la requête PATCH /comments/:id.

Branch Name

docs/update-api-doc-for-patch-comment-route

@benoit-bremaud benoit-bremaud self-assigned this Jul 20, 2024
@benoit-bremaud benoit-bremaud added documentation Improvements or additions to documentation backend Label to indicate the backend team api Related to API documentation and implementation and removed backend Label to indicate the backend team labels Jul 20, 2024
@benoit-bremaud benoit-bremaud changed the title Mettre à jour la documentation de l'API pour inclure la nouvelle route PATCH /comments/:id. docs/update-api-doc-for-patch-comment-route Jul 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
api Related to API documentation and implementation backend Label to indicate the backend team documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant