Сообщение от nerv_
			 
		
	 | 
	
		а для тупых можно поподробней?  
	 | 
	
https://developers.google.com/closur...s-for-compiler
GCC понимает эти анотации и использует их чтобы генерировать как можно более оптимальный и эффективный код.
	
	
		
			Сообщение от nerv_
			 
		
	 | 
	| 
		аналогичный вопрос
	 | 
	
Многие JS IDE понимают JSDoc, в частности WebStorm понимает стандарт GCC JSDoc и использует его для статического анализа кода и автокомплита.
Соглашения - ну тут всё понятно, ибо когда мы вводим рамки и следуем им, то наш код становится более предсказуем и очевиден.
Ну а здравый смысл - это думать, что делаешь
