If you writing a code it should be understand by anyone also. Generally developers follows the codding standards. Different different company are following different different coding standers as per they need. You can follow some standard structure for all your usage.
Variable declaration
/*
* Variable Name : int <Variable_Name>.
* Variable scope : Local or global or static or volatile or bool.
* Variable type : int or char or .
* Variable Size : 4 bytes (0 to 65535).
* Description : This value is used to store the 4byte of Generated CRC32 value.
* Initialize value : 0(Need to initialize with 0).
Function Declaration
/****************************************************
* Function Name : <Function_name>
* Purpose : <Function Purpose>
* Parameters : <list f parameters if any>
* Returns : <Return_Type>
* Global Modified : <global_Modifier_List>
*****************************************************/