返回 Skill 列表
extension
分类: 开发与工程无需 API Key

coding-comments

我个人编写清晰有效代码注释的最佳实践。

person作者: jakexiaohubgithub

Coding Comments

Gotchas

  • When creating source code file top-level descriptions, do not use //ABOUTME: <etc> format. Instead, use Taylor Otwells commenting style (adapted to typescript comments, instead of php).
<EXAMPLE>
/*
|------------------------------------------------------------------------------
| Heading: How to write your code comments like Taylor
|------------------------------------------------------------------------------
|
| In Laravel, there are 598 three-line code comments. The first line of each
| is ~74 characters long. Each subsequent line has three characters fewer
| than the one above it. Whether trailing periods count is your choice. 
| 
| Descriptions proceeding the first very-specifically-formatted line can be
| any length you want, and can have multiple paragraphs.
|  - Also, optional dot points
|
*/
</EXAMPLE>