update docs (#7636)
parent
14443947b0
commit
38a1ed18b8
|
@ -0,0 +1,29 @@
|
||||||
|
# Quy tắc Ứng xử của Cộng tác viên
|
||||||
|
|
||||||
|
Với tư cách là những người đóng góp và duy trì dự án này, và vì lợi ích nuôi dưỡng một cộng đồng cởi mở và thân thiện, chúng tôi cam kết tôn trọng tất cả những người đóng góp thông qua các vấn đề, yêu cầu tính năng, cập nhật tài liệu, gửi yêu cầu kéo hoặc bản vá và các hoạt động khác.
|
||||||
|
|
||||||
|
Chúng tôi cam kết làm cho việc tham gia vào dự án này không bị quấy rối trải nghiệm cho tất cả mọi người, bất kể mức độ kinh nghiệm, giới tính, giới tính nhận dạng và biểu hiện, khuynh hướng tình dục, khuyết tật, ngoại hình cá nhân, kích thước cơ thể, chủng tộc, dân tộc, tuổi tác, tôn giáo hoặc quốc tịch.
|
||||||
|
|
||||||
|
Ví dụ về hành vi không được chấp nhận của những người tham gia bao gồm:
|
||||||
|
|
||||||
|
* Việc sử dụng ngôn ngữ hoặc hình ảnh khiêu dâm
|
||||||
|
* Tấn công cá nhân
|
||||||
|
* Những bình luận mang tính chế nhạo hoặc lăng mạ/xúc phạm
|
||||||
|
* Quấy rối công khai hoặc riêng tư
|
||||||
|
* Xuất bản thông tin cá nhân của người khác, chẳng hạn như vật lý hoặc điện tử địa chỉ mà không có sự cho phép rõ ràng
|
||||||
|
* Hành vi phi đạo đức hoặc không chuyên nghiệp khác
|
||||||
|
|
||||||
|
Người bảo trì dự án có quyền và trách nhiệm loại bỏ, chỉnh sửa hoặc từ chối nhận xét, cam kết, mã, chỉnh sửa wiki, các vấn đề và các đóng góp khác không phù hợp với Quy tắc ứng xử này hoặc cấm tạm thời hoặc vĩnh viễn bất kỳ người đóng góp nào cho các hành vi khác mà họ cho là không phù hợp, đe dọa, xúc phạm hoặc có hại.
|
||||||
|
|
||||||
|
Bằng cách áp dụng Quy tắc ứng xử này, những người duy trì dự án cam kết áp dụng công bằng và nhất quán các nguyên tắc này cho mọi khía cạnh của việc quản lý dự án này. Những người duy trì dự án không tuân theo hoặc thực thi Quy tắc của Hạnh kiểm có thể bị xóa vĩnh viễn khỏi nhóm dự án.
|
||||||
|
|
||||||
|
Quy tắc ứng xử này áp dụng cả trong không gian dự án và không gian công cộng khi một cá nhân đại diện cho dự án hoặc cộng đồng của nó.
|
||||||
|
|
||||||
|
Các trường hợp lạm dụng, quấy rối hoặc hành vi không thể chấp nhận được có thể là được báo cáo bằng cách liên hệ với người bảo trì dự án tại victorfelder tại gmail.com. Tất cả các khiếu nại sẽ được xem xét và điều tra và sẽ dẫn đến phản hồi được cho là cần thiết và phù hợp với hoàn cảnh. Người bảo trì là có nghĩa vụ duy trì tính bảo mật liên quan đến người báo cáo của một sự cố.
|
||||||
|
|
||||||
|
|
||||||
|
Quy tắc ứng xử này được điều chỉnh từ [Giao ước cộng tác viên][trang chủ], phiên bản 1.3.0, có tại https://contributor-covenant.org/version/1/3/0/
|
||||||
|
|
||||||
|
[trang chủ]: https://contributor-covenant.org
|
||||||
|
|
||||||
|
[Translations](README.md#translations)
|
|
@ -6,7 +6,7 @@ Bản dịch Tiếng Việt:
|
||||||
|
|
||||||
- Tôi đã cố gắng dịch chính xác, nhưng khó có thể tránh khỏi một số sai sót, mong các bạn lượng thứ.
|
- Tôi đã cố gắng dịch chính xác, nhưng khó có thể tránh khỏi một số sai sót, mong các bạn lượng thứ.
|
||||||
|
|
||||||
- Mọi ý kiến, đóng góp về bản dịch, vui lòng [tạo một issue mới](/issues/new) hoặc bạn có thể chỉnh sửa và tạo pull Request.
|
- Mọi ý kiến, đóng góp về bản dịch, vui lòng [tạo một issue mới](/issues/new) hoặc bạn có thể chỉnh sửa và tạo Pull Request (PR).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -33,7 +33,7 @@ Bằng cách đóng góp, bạn đồng ý tôn trọng [Quy Tắc Ứng Xử](C
|
||||||
- *Sách* : PDF, HTML, ePub, một trang web dựa trên gitbook.io, một kho lưu trữ Git, v.v.
|
- *Sách* : PDF, HTML, ePub, một trang web dựa trên gitbook.io, một kho lưu trữ Git, v.v.
|
||||||
- *Khóa Học* : Một khóa học là một tài liệu học tập, không phải là sách. [Đây là một khóa học](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
|
- *Khóa Học* : Một khóa học là một tài liệu học tập, không phải là sách. [Đây là một khóa học](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
|
||||||
- *Hướng Dẫn Trực Quan* : Một trang web cho phép người dùng lập trình hoặc chạy chương trình dựa trên kết quả và đánh giá. Ví dụ: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
|
- *Hướng Dẫn Trực Quan* : Một trang web cho phép người dùng lập trình hoặc chạy chương trình dựa trên kết quả và đánh giá. Ví dụ: [Try Haskell](http://tryhaskell.org), [Try GitHub](http://try.github.io).
|
||||||
- *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code.
|
- *Playgrounds* : các trang web, trò chơi hoặc phần mềm máy tính trực tuyến cho việc học lập trình. Viết, biên dịch (hoặc chạy), và chia sẻ các đoạn mã. Playgrounds thường cho phép bạn fork và nhúng tay chơi đùa với các dòng code.
|
||||||
- *Podcasts và Screencasts* : Podcasts và screencasts.
|
- *Podcasts và Screencasts* : Podcasts và screencasts.
|
||||||
- *Bài Tập & Cuộc Thi Lập Trình* : Trang web hoặc phần mềm cho phép bạn đánh giá kỹ năng lập trình của mình bằng cách giải quyết các vấn đề đơn giản hoặc phức tạp, có hoặc không có đánh giá mã nguồn, có hoặc không so sánh kết quả với những người khác.
|
- *Bài Tập & Cuộc Thi Lập Trình* : Trang web hoặc phần mềm cho phép bạn đánh giá kỹ năng lập trình của mình bằng cách giải quyết các vấn đề đơn giản hoặc phức tạp, có hoặc không có đánh giá mã nguồn, có hoặc không so sánh kết quả với những người khác.
|
||||||
|
|
||||||
|
@ -65,8 +65,8 @@ Bằng cách đóng góp, bạn đồng ý tôn trọng [Quy Tắc Ứng Xử](C
|
||||||
- ưu tiên các commit nhỏ (atomic commits - một commit chỉ có thêm, xóa hoặc sửa) hơn các commit lớn. Không cần phải giấu các commits của bạn trước khi gửi PR. (Chúng tôi sẽ không bao giờ thực thi những thứ này vì nó thuận tiện sau này cho người bảo trì)
|
- ưu tiên các commit nhỏ (atomic commits - một commit chỉ có thêm, xóa hoặc sửa) hơn các commit lớn. Không cần phải giấu các commits của bạn trước khi gửi PR. (Chúng tôi sẽ không bao giờ thực thi những thứ này vì nó thuận tiện sau này cho người bảo trì)
|
||||||
- nếu sách cũ, hãy bao gồm ngày xuất bản cùng với tên sách.
|
- nếu sách cũ, hãy bao gồm ngày xuất bản cùng với tên sách.
|
||||||
- bao gồm tên tác giả hoặc tên nếu thích hợp. Bạn có thể rút ngắn danh sách tác giả với "`et al.`".
|
- bao gồm tên tác giả hoặc tên nếu thích hợp. Bạn có thể rút ngắn danh sách tác giả với "`et al.`".
|
||||||
- nếu cuốn sách chưa hoàn thành và vẫn đang được hoàn thiện, hãy thêm ký hiệu "`đang xử lý`", như được mô tả [dưới đây](#in_process).
|
- nếu cuốn sách chưa hoàn thành và vẫn đang được hoàn thiện, hãy thêm chú thích "`đang xử lý`", như được mô tả [dưới đây](#in_process).
|
||||||
- if a resource is restored using the [*Internet Archive's Wayback Machine*](https://web.archive.org) (or similar), add the "`archived`" notation, as described [below](#archived). The best versions to use are recent and complete.
|
- nếu tài nguyên được khôi phục bằng cách sử dụng [*Internet Archive's Wayback Machine*](https://web.archive.org) (hoặc tương tự), hãy thêm chú thích "`lưu trữ`", như được mô tả [bên dưới](#archived). Các phiên bản tốt nhất để sử dụng là gần đây và hoàn chỉnh.
|
||||||
- nếu địa chỉ email hoặc thiết lập tài khoản được yêu cầu trước khi kích hoạt tải xuống, hãy thêm ghi chú phù hợp với ngôn ngữ trong ngoặc đơn, ví dụ: `(địa chỉ email *được yêu cầu*, không bắt buộc)`.
|
- nếu địa chỉ email hoặc thiết lập tài khoản được yêu cầu trước khi kích hoạt tải xuống, hãy thêm ghi chú phù hợp với ngôn ngữ trong ngoặc đơn, ví dụ: `(địa chỉ email *được yêu cầu*, không bắt buộc)`.
|
||||||
|
|
||||||
|
|
||||||
|
@ -145,18 +145,18 @@ Ví dụ:
|
||||||
TỐT: * [Sách sẽ sớm trở nên tuyệt vời](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
TỐT: * [Sách sẽ sớm trở nên tuyệt vời](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
|
||||||
```
|
```
|
||||||
|
|
||||||
- <a id="archived"></a>Archived link:
|
- <a id="archived"></a>Liên kết đã lưu trữ:
|
||||||
|
|
||||||
```text
|
```text
|
||||||
TỐT: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
|
TỐT: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)*
|
||||||
```
|
```
|
||||||
|
|
||||||
### Alphabetical order
|
### Thứ tự bảng chữ cái
|
||||||
|
|
||||||
- When there are multiple titles beginning with the same letter order them by the second, and so on. For example: `aa` comes before `ab`.
|
- Khi có nhiều tiêu đề bắt đầu bằng cùng một chữ cái, hãy sắp xếp chúng theo thứ tự thứ hai, v.v. Ví dụ: `aa` đứng trước` ab`.
|
||||||
- `one two` comes before `onetwo`
|
- `một hai` đến trước `mộthai`
|
||||||
|
|
||||||
If you see a misplaced link, check the linter error message to know which lines should be swapped.
|
Nếu bạn thấy một liên kết bị đặt sai vị trí, hãy kiểm tra thông báo lỗi với linter để biết dòng nào nên được hoán đổi.
|
||||||
|
|
||||||
|
|
||||||
### Ghi Chú
|
### Ghi Chú
|
||||||
|
@ -173,7 +173,7 @@ Danh sách của chúng tôi cung cấp một metadata: tiêu đề, URL, ngư
|
||||||
|
|
||||||
- Không được phát minh ra tiêu đề. Chúng tôi cố gắng lấy các tiêu đề từ chính các nguồn tài liệu đó; những người đóng góp được khuyến cáo không phát minh ra tiêu đề hoặc chỉnh sửa chúng nếu điều này có thể tránh được. Một ngoại lệ là đối với các tác phẩm cũ hơn; nếu họ chủ yếu quan tâm đến lịch sử, thêm số năm vào trong dấu ngoặc đơn nằm trong tiêu đề sẽ giúp người dùng biết liệu họ có quan tâm hay không.
|
- Không được phát minh ra tiêu đề. Chúng tôi cố gắng lấy các tiêu đề từ chính các nguồn tài liệu đó; những người đóng góp được khuyến cáo không phát minh ra tiêu đề hoặc chỉnh sửa chúng nếu điều này có thể tránh được. Một ngoại lệ là đối với các tác phẩm cũ hơn; nếu họ chủ yếu quan tâm đến lịch sử, thêm số năm vào trong dấu ngoặc đơn nằm trong tiêu đề sẽ giúp người dùng biết liệu họ có quan tâm hay không.
|
||||||
- Không sử dụng tiêu đề viết HOA TOÀN BỘ. Thông thường, viết hoa tiêu đề là phù hợp, nhưng khi không chắc chắn, hãy sử dụng chữ viết hoa từ nguồn.
|
- Không sử dụng tiêu đề viết HOA TOÀN BỘ. Thông thường, viết hoa tiêu đề là phù hợp, nhưng khi không chắc chắn, hãy sử dụng chữ viết hoa từ nguồn.
|
||||||
- No emojis.
|
- Không emojis.
|
||||||
|
|
||||||
|
|
||||||
##### Các Liên Kết
|
##### Các Liên Kết
|
||||||
|
@ -188,17 +188,17 @@ Danh sách của chúng tôi cung cấp một metadata: tiêu đề, URL, ngư
|
||||||
##### Người Sáng Tạo
|
##### Người Sáng Tạo
|
||||||
|
|
||||||
- Chúng tôi muốn ghi công những người tạo ra các tài liệu miễn phí nếu thích hợp, bao gồm cả những người dịch!
|
- Chúng tôi muốn ghi công những người tạo ra các tài liệu miễn phí nếu thích hợp, bao gồm cả những người dịch!
|
||||||
- Đối với các tác phẩm đã dịch, tác giả gốc nên được ghi công. We recommend using [MARC relators](https://loc.gov/marc/relators/relaterm.html) to credit creators other than authors, as in this example:
|
- Đối với các tác phẩm đã dịch, tác giả gốc nên được đề cập. Chúng tôi cân nhắc sử dụng [MARC relators](https://loc.gov/marc/relators/relaterm.html) để đề cập tới người sáng tạo không phải tác giả, như ví dụ dưới đây:
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
* [A Translated Book](http://example.com/book-vi.html) - John Doe, `trl.:` Mike The Translator
|
* [A Translated Book](http://example.com/book-vi.html) - John Doe, `trl.:` Mike The Translator
|
||||||
```
|
```
|
||||||
|
|
||||||
here, the annotation `trl.:` uses the MARC relator code for "translator".
|
ở đây, chú thích `trl.:` sử dụng MARC liên quan đến "người dịch".
|
||||||
- Use a comma `,` to delimit each item in the author list.
|
- Sử dụng một dấu phẩu `,` để phân định mỗi tác giả trong danh sách tác giả.
|
||||||
- You can shorten author lists with "`et al.`".
|
- Bạn có thể rút ngắn tác giả với "`et al.`".
|
||||||
- Chúng tôi không cho phép liên kết bởi Người sáng tạo.
|
- Chúng tôi không cho phép liên kết bởi Người sáng tạo.
|
||||||
- Đối với các tác phẩm tổng hợp hoặc phối lại, "người sáng tạo" có thể cần mô tả. Ví dụ: sách "GoalKicker" or "RIP Tutorial" được ghi là "`Được tổng hợp từ tài liệu StackOverflow`" (bằng tiếng anh: "`Compiled from StackOverflow documentation`").
|
- Đối với các tác phẩm tổng hợp hoặc phối lại, "người sáng tạo" có thể cần mô tả. Ví dụ: sách "GoalKicker" hoặc "RIP Tutorial" được ghi là "`Được tổng hợp từ tài liệu StackOverflow`" (tiếng Anh là "`Compiled from StackOverflow documentation`").
|
||||||
|
|
||||||
|
|
||||||
##### Nền Tảng và Ghi Chú Truy Cập
|
##### Nền Tảng và Ghi Chú Truy Cập
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
# How-To at a glance
|
# How-To trong một cái nháy mắt
|
||||||
|
|
||||||
<div align="right" markdown="1">
|
<div align="right" markdown="1">
|
||||||
|
|
||||||
|
@ -18,10 +18,10 @@ Chúng tôi chào đón những người đóng góp mới, kể cả khi nhữn
|
||||||
* [YouTube - Khóa học về Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(bằng Tiếng Anh)*
|
* [YouTube - Khóa học về Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(bằng Tiếng Anh)*
|
||||||
|
|
||||||
|
|
||||||
Đừng do dự khi đặt câu hỏi; mọi người đóng góp đã bắt đầu với Pull Request (PR) đầu tiên. Bạn có thể là người tiếp theo! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community.
|
Đừng do dự khi đặt câu hỏi; mọi người đóng góp đã bắt đầu với Pull Request (PR) đầu tiên. Bạn có thể là người tiếp theo! Vậy nên... tại so không tham gia với cộng đồng [rộng lớn, đang phát triển](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) của chúng tôi.
|
||||||
|
|
||||||
<details align="center" markdown="1">
|
<details align="center" markdown="1">
|
||||||
<summary>Click to see the growth users vs. time graphs.</summary>
|
<summary>Nhấp vào để xem tăng trưởng người dùng và đồ thị thời gian.</summary>
|
||||||
|
|
||||||
[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)
|
[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)
|
||||||
|
|
||||||
|
|
|
@ -109,6 +109,7 @@ Volunteers have translated many of our Contributing, How-to, and Code of Conduct
|
||||||
- [Кодекс Поведінки](CODE_OF_CONDUCT-uk.md)
|
- [Кодекс Поведінки](CODE_OF_CONDUCT-uk.md)
|
||||||
- [How-to](HOWTO-uk.md)
|
- [How-to](HOWTO-uk.md)
|
||||||
- Vietnamese / Tiếng Việt
|
- Vietnamese / Tiếng Việt
|
||||||
|
- [Quy tắc ứng sử](CODE_OF_CONDUCT-vi.md)
|
||||||
- [Đóng Góp](CONTRIBUTING-vi.md)
|
- [Đóng Góp](CONTRIBUTING-vi.md)
|
||||||
- [How-to](HOWTO-vi.md)
|
- [How-to](HOWTO-vi.md)
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue