Skip to content

Commit 29ef3c0

Browse files
authored
Translate 9-Formatting (hienvd#7)
1 parent 7df6b26 commit 29ef3c0

File tree

1 file changed

+26
-21
lines changed

1 file changed

+26
-21
lines changed

README.md

Lines changed: 26 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Original Repository: [ryanmcdermott/clean-code-javascript](https://github.com/ry
1111
6. [Testing](#testing)
1212
7. [Concurrency](#concurrency)
1313
8. [Xử lí lỗi](#xử-lí-lỗi)
14-
9. [Formatting](#formatting)
14+
9. [Định dạng](#định-dạng)
1515
10. [Viết chú thích](#viết-chú-thích)
1616
11. [Các ngôn ngữ khác](#các-ngôn-ngữ-khác)
1717

@@ -1915,22 +1915,25 @@ getdata()
19151915
**[⬆ về trang chủ](#mục-lục)**
19161916

19171917

1918-
## **Formatting**
1919-
Formatting is subjective. Like many rules herein, there is no hard and fast
1920-
rule that you must follow. The main point is DO NOT ARGUE over formatting.
1921-
There are [tons of tools](http://standardjs.com/rules.html) to automate this.
1922-
Use one! It's a waste of time and money for engineers to argue over formatting.
1918+
## **Định dạng**
1919+
Việc định dạng code mang tính chủ quan. Giống như nhiều quy tắc được trình
1920+
bày trong tài liệu này, không có quy tắc nào cứng nhắc và nhanh chóng mà bạn
1921+
bắt buộc phải tuân theo. Điểm chính của phần này là ĐỪNG BAO GIỜ TRANH CÃI
1922+
về việc định dạng code như thế nào. Có [hàng tá công cụ](http://standardjs.com/rules.html)
1923+
để tự động hoá việc này. Hãy sử dụng một công cụ nào đó! Thật tốn thời gian và
1924+
tiền bạc chỉ để tranh cãi về vấn đề định dạng code.
19231925

1924-
For things that don't fall under the purview of automatic formatting
1925-
(indentation, tabs vs. spaces, double vs. single quotes, etc.) look here
1926-
for some guidance.
1926+
Đối với những thứ không thuộc phạm vi của việc tự động định dạng code (thụt đầu
1927+
dòng, tab và space, nháy đơn và nháy kép,..) hãy xem một số hướng dẫn ở đây.
19271928

1928-
### Use consistent capitalization
1929-
JavaScript is untyped, so capitalization tells you a lot about your variables,
1930-
functions, etc. These rules are subjective, so your team can choose whatever
1931-
they want. The point is, no matter what you all choose, just be consistent.
1929+
### Sử dụng thống nhất cách viết hoa
1930+
Javascript là một ngôn ngữ không định kiểu, vì vậy việc viết hoa sẽ nói lên rất
1931+
nhiều về các biến, hàm,.. của bạn. Những quy tắc này thì mang tính chủ quan,
1932+
vì thế team bạn có thể chọn quy tắc nào họ muốn. Tuy nhiên điều quan trọng là
1933+
dù bạn chọn cách viết như thế nào, thì cũng hãy sử dụng thống nhất nó trong
1934+
codebase của bạn.
19321935

1933-
**Bad:**
1936+
**Không tốt:**
19341937
```javascript
19351938
const DAYS_IN_WEEK = 7;
19361939
const daysInMonth = 30;
@@ -1945,7 +1948,7 @@ class animal {}
19451948
class Alpaca {}
19461949
```
19471950

1948-
**Good:**
1951+
**Tốt:**
19491952
```javascript
19501953
const DAYS_IN_WEEK = 7;
19511954
const DAYS_IN_MONTH = 30;
@@ -1959,13 +1962,14 @@ function restoreDatabase() {}
19591962
class Animal {}
19601963
class Alpaca {}
19611964
```
1962-
**[back to top](#mục-lục)**
1965+
**[về đầu trang](#mục-lục)**
19631966

19641967

1965-
### Function callers and callees should be close
1966-
If a function calls another, keep those functions vertically close in the source
1967-
file. Ideally, keep the caller right above the callee. We tend to read code from
1968-
top-to-bottom, like a newspaper. Because of this, make your code read that way.
1968+
### Các hàm gọi và hàm được gọi nên nằm gần nhau
1969+
Nếu một hàm gọi một hàm khác, hãy giữ những hàm này nằm gần theo chiều dọc trong
1970+
file. Lí tưởng là, hãy giữ cho hàm gọi ở trên hàm được gọi. Chúng ta có xu hướng
1971+
đọc code từ trên xuống, giống như đọc báo vậy. Do đó, hãy làm cho code của chúng
1972+
ta cũng được đọc theo cách đó.
19691973

19701974
**Bad:**
19711975
```javascript
@@ -2045,7 +2049,7 @@ const review = new PerformanceReview(employee);
20452049
review.perfReview();
20462050
```
20472051

2048-
**[back to top](#mục-lục)**
2052+
**[về trang chủ](#mục-lục)**
20492053

20502054
## **Viết chú thích**
20512055
### Chỉ nên viết chú thích cho những thứ có logic phức tạp.
@@ -2175,6 +2179,7 @@ const actions = function() {
21752179

21762180
Tài liệu này cũng có sẵn ở các ngôn ngữ sau:
21772181

2182+
- ![en](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags-iso/shiny/24/US.png) **English**: [ryanmcdermott/clean-code-javascript](https://github.com/ryanmcdermott/clean-code-javascript)
21782183
- ![br](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Brazil.png) **Brazilian Portuguese**: [fesnt/clean-code-javascript](https://github.com/fesnt/clean-code-javascript)
21792184
- ![cn](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/China.png) **Chinese**: [alivebao/clean-code-js](https://github.com/alivebao/clean-code-js)
21802185
- ![de](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/Germany.png) **German**: [marcbruederlin/clean-code-javascript](https://github.com/marcbruederlin/clean-code-javascript)

0 commit comments

Comments
 (0)