Exemples d'en-tête de commentaire SQL

Question

J'aimerais juste voir à quoi ressemblent les en-têtes de commentaires des procédures stockées/fonctions etc... (alors postez vos exemples)... Je n'ai vraiment vu que ce que le SQL Server Management Studio crée mais je suis intéressé par ce à quoi ressemblent les autres... le formatage, les caractères utilisés, les informations/détails de la procédure etc... je suppose que c'est ce qui les rend vraiment différents...

En-tête de commentaire par défaut de la procédure stockée de SQL Server Management Studio (version 9) :

-- =============================================
-- Author:      Name
-- Create date: 
-- Description: 
-- =============================================

Answer 1

Voici ma variante préférée :

/* =====================================================================
DESC:   Some notes about what this does
           tabbed in if you need additional lines
NOTES:  Additional notes
           tabbed in if you need additional lines
======================================================================== */

Answer 2

-- Author: 
--
-- Original creation date: 
--
-- Description:

Answer 3

Voici ce que j'utilise actuellement. Le triple commentaire ( / * / * / * ) est destiné à une intégration qui extrait les commentaires d'en-tête de la définition de l'objet.

/*/*/*

    Name:           pr_ProcName
    Author:         Joe Smith
    Written:        6/15/16
    Purpose:        Short description about the proc.

    Edit History:   6/15/16 - Joe Smith
                        + Initial creation.
                    6/22/16 - Jaden Smith
                        + Change source to blahblah
                        + Optimized JOIN
                    6/30/16 - Joe Smith
                        + Reverted changes made by Jaden.

*/*/*/