بسیاری از توسعه دهندگان PHP کامنت‌هایی را برای کدهایشان می‌نویسند، اما این زبان خودش هیچ قوانینی برای اینکه چگونه اینکار را انجام دهید ندارد. بنابراین دقیقا چه چیزی را باید در بلاک‌های کامنت بنویسید تا آنها کاربردی و سودمند باشند؟ چه بخش‌هایی از کد باید مستندسازی شود و چه بخش‌های نباید؟ در ادامه به برخی نکات مهم برای نامگذاری صحیح، مشخص کردن محدوده دسترسی و Type hinting پرداخته شده که رعایت آنها به شما در قابل فهم شدن و مستندسازی بهتر کدهای PHP تان کمک خواهد کرد.