Structured Commentary Markup Language
# Structured Commentary Markup Language

Le Structured Commentary Markup Language, aussi Structured Changelog Markup Language, mais aussi Structured Commit Markup Language, abrégé SCML, est conçu pour structuré les commentaires dans une page web ou pour le suivi des modifications, également appelé versionnage. C’est un langage de balisage, c'est-à-dire qu'il fonctionne avec des mots-balises, afin de délimiter une séquence de caractères (phrase, mot) ou en marquant une action précise, permettant de structurer et de rendre plus pertinent un commentaire, une modification apportée à un document, ou à un logiciel.

Le SCML rend ainsi la liste des changements, plus riche et interactif.

Le langage est actuellement en version 2.

## Dénominations

L’anglais Structured Commentary Markup Language se traduit littéralement en langage de balisage de commentaire structuré.

## Applications

Le SCML permet une utilisation sur des cas concrets, comme le commit sur le logiciel GitLab, mais aussi lors de la rédaction de commentaire et/ou d'actions, effectués par le technicien sur des logiciels de gestion des services d'assistance (appelé ticketing), comme GLPI par exemple.

Concrètement, il est également possible d'utiliser le SCML sur Wikipédia, lors de la publication des modifications. Un résumé, bref et succin des modifications apportés, structuré en SCML, permet une lecture plus facile et rapide des changements apportés à une page lors de sa rédaction (ou correction).

### Syntaxe

Le SCML se caractérise par la présence d'un titre, singulièrement pour signaler la version du logiciel. Les balises "<#scml" et "#>" sont facultatives; Elles permettent de signaler quelle sont les règles de syntaxe adoptées pour le commentaire. Ensuite, le commentaire se détail par l'utilisation de plusieurs caractères, respectivement :

## Spécificités

Le SCML est un langage à la syntaxe simple et facile à apprendre. Sa tolérance lui permet une adaptation facile sur tous types d'applications. Ainsi, un document HTML ou même un document texte, grâce à leurs balises de commentaires respectifs, permet une organisation avec du SCML.

## Sources

Documentation du Structured Commentary Markup Language

