File tree
Expand file treeCollapse file tree1 file changed
+35
-0
lines changed Expand file treeCollapse file tree1 file changed
+35
-0
lines changed Original file line number | Diff line number | Diff line change |
---|
@@ -1753,6 +1753,41 @@ function combine(a, b) {
|
1753 | 1753 | ```
|
1754 | 1754 | **[⬆ back to top](#table-of-contents)**
|
1755 | 1755 |
|
| 1756 | +### Avoid positional markers |
| 1757 | +They usually just add noise. Let the functions and variable names along with the |
| 1758 | +proper indentation and formatting give the visual structure to your code. |
| 1759 | + |
| 1760 | +**Bad:** |
| 1761 | +```javascript |
| 1762 | +//////////////////////////////////////////////////////////////////////////////// |
| 1763 | +// Scope Model Instantiation |
| 1764 | +//////////////////////////////////////////////////////////////////////////////// |
| 1765 | +let $scope.model = { |
| 1766 | +menu: 'foo', |
| 1767 | +nav: 'bar' |
| 1768 | +}; |
| 1769 | + |
| 1770 | +//////////////////////////////////////////////////////////////////////////////// |
| 1771 | +// Action setup |
| 1772 | +//////////////////////////////////////////////////////////////////////////////// |
| 1773 | +let actions = function() { |
| 1774 | +// ... |
| 1775 | +} |
| 1776 | +``` |
| 1777 | + |
| 1778 | +**Good**: |
| 1779 | +```javascript |
| 1780 | +let $scope.model = { |
| 1781 | +menu: 'foo', |
| 1782 | +nav: 'bar' |
| 1783 | +}; |
| 1784 | + |
| 1785 | +let actions = function() { |
| 1786 | +// ... |
| 1787 | +} |
| 1788 | +``` |
| 1789 | +**[⬆ back to top](#table-of-contents)** |
| 1790 | + |
1756 | 1791 | ### Avoid legal comments in source files
|
1757 | 1792 | That's what your `LICENSE` file at the top of your source tree is for.
|
1758 | 1793 |
|
|
You can’t perform that action at this time.
0 commit comments