Cùng đóng góp

Do năng lực có hạn, cuốn sách này không tránh khỏi những thiếu sót và sai sót. Chúng tôi rất mong nhận được sự thông cảm từ bạn và biết ơn sự giúp đỡ của bạn trong việc chỉnh sửa chúng. Nếu bạn phát hiện ra lỗi chính tả, liên kết bị hỏng, thiếu nội dung, từ ngữ mơ hồ, giải thích không rõ ràng hoặc các vấn đề về cấu trúc, vui lòng giúp chúng tôi thực hiện các sửa đổi để cung cấp cho người đọc tài liệu học tập có chất lượng cao hơn.

Tài khoản GitHub của tất cả các nhà đóng góp sẽ được hiển thị trên trang chủ của kho lưu trữ sách, phiên bản web và phiên bản PDF để ghi nhận những đóng góp quên mình của họ cho cộng đồng mã nguồn mở (open source).

Sức hút của mã nguồn mở

Khoảng thời gian giữa hai lần in của một cuốn sách giấy thường khá dài, khiến việc cập nhật nội dung rất bất tiện.

Trong cuốn sách mã nguồn mở này, thời gian cập nhật nội dung đã được rút ngắn chỉ còn vài ngày hoặc thậm chí vài giờ.

Điều chỉnh nội dung nhỏ

Như được hiển thị trong hình bên dưới, có một "biểu tượng chỉnh sửa" ở góc trên cùng bên phải của mỗi trang. Bạn có thể sửa đổi văn bản hoặc mã nguồn bằng cách thực hiện các bước sau.

1. Nhấp vào "biểu tượng chỉnh sửa". Nếu bạn gặp thông báo yêu cầu "tạo bản sao (fork) kho lưu trữ này", vui lòng đồng ý.
2. Sửa đổi nội dung của tệp nguồn Markdown, xác minh tính chính xác của nội dung và duy trì định dạng nhất quán nhất có thể.
3. Điền mô tả về các thay đổi của bạn ở cuối trang, sau đó nhấp vào nút "Propose file change". Sau khi trang mới tải xong, nhấp vào nút "Create pull request" để gửi yêu cầu đóng góp (pull request) của bạn.

Không thể chỉnh sửa hình ảnh trực tiếp. Vui lòng mô tả vấn đề bằng cách tạo một vấn đề (issue) mới hoặc để lại bình luận. Chúng tôi sẽ nhanh chóng vẽ lại và thay thế các hình ảnh.

Sáng tạo nội dung

Nếu bạn muốn đóng góp cho dự án mã nguồn mở này, bao gồm cả việc dịch mã nguồn sang các ngôn ngữ lập trình khác hoặc mở rộng nội dung bài viết, bạn sẽ cần tuân theo quy trình làm việc Pull Request dưới đây.

1. Đăng nhập vào GitHub và thực hiện Fork kho lưu trữ mã nguồn của cuốn sách về tài khoản cá nhân của bạn.
2. Truy cập trang kho lưu trữ đã fork của bạn và sử dụng lệnh git clone để sao chép kho lưu trữ về máy cục bộ.
3. Tạo nội dung cục bộ và tiến hành kiểm thử toàn diện để xác minh tính chính xác của mã nguồn.
4. Commit các thay đổi cục bộ và đẩy (push) chúng lên kho lưu trữ từ xa.
5. Làm mới trang web kho lưu trữ và nhấp vào nút "Create pull request" để gửi yêu cầu đóng góp của bạn.

Triển khai Docker

Từ thư mục gốc của hello-algo, chạy lệnh Docker sau để truy cập dự án tại http://localhost:8000:

docker-compose up -d

Sử dụng lệnh sau để gỡ bỏ triển khai:

docker-compose down