Các lập trình viên GitHub thường thêm ảnh chụp màn hình (screenshots) hoặc GIF hoạt ảnh (animated GIFs) vào pull request của repository. Các kỹ thuật này chắc chắn thu hút mắt hơn là khiến ai đó đọc vài dòng văn bản thuần túy. Thêm ảnh chụp màn hình tĩnh (static screenshots) hữu ích nếu bạn muốn chèn thay đổi trực quan hoặc hình ảnh inline. Một GIF animation là một cách hay để minh họa luồng quy trình (process flows) và chuyển động con trỏ chuột.
Hướng dẫn sau sẽ chỉ cho bạn ngay từ đầu cách thêm ảnh chụp màn hình và GIF animation vào GitHub pull requests. Ngay cả khi bạn chưa từng dùng GitHub trước đây, bạn có thể dùng các bước này để bắt đầu.
1. Thêm Repository và Branch mới
Nếu bạn mới với thế giới GitHub, hãy làm theo quy trình ở đây để tạo tài khoản.
Nhấp dấu "+" ở góc trên bên phải để tạo repository mới. Nhớ chọn tùy chọn "Initialize this repository with a README".
Ở giai đoạn tiếp theo, thêm một branch vào repository của bạn sử dụng menu thả xuống như hình dưới. Ở đây, branch "Guten-tag" đã được thêm vào repository "Hola-World".
Mục đích của một branch trong GitHub là giúp nhà phát triển làm việc trên tính năng và sửa lỗi (bug fixes) tách biệt từ branch production master.
2. Tạo Ảnh chụp màn hình hoặc Animation
Để thêm ảnh chụp màn hình, bạn cần một phần mềm chụp màn hình tốt. Trên Windows 10, một số công cụ tốt và dễ dùng nhất là Snip & Sketch và Snipping Tool.
Để thêm GIF animation, bạn cần một công cụ quay màn hình video tốt. Một công cụ được khuyến nghị là Recordit, cực kỳ dễ dùng cho screencasting nhanh. Nó có sẵn dưới dạng tải xuống trực tiếp cho cả Windows và macOS.
Sau khi cài đặt, bạn có thể quay vài giây bất kỳ màn hình nào bằng nút Record (Quay). Tất cả screencast gần đây của bạn sẽ hiển thị từ menu khay hệ thống (system tray) và mở trong trình duyệt.
Vì GitHub pull requests không cho phép file video (MP4, v.v.), bạn sẽ cần chuyển đổi chúng thành file GIF. Thực tế, nó chỉ hỗ trợ một số lượng file tùy chỉnh rất hạn chế: JPG, JPEG, GIF, PNG, DOCX, PPTX, PDF, TXT, XLSX, và ZIP. Bạn có thể dễ dàng chuyển đổi MP4 sang GIF bằng Ezgif hoặc bất kỳ công cụ trực tuyến nào khác.
File GIF được tạo sau sẽ được chèn vào một GitHub pull request. Nó minh họa chuỗi đơn giản thêm một branch mới vào repository GitHub bằng ứng dụng GitHub Desktop.
3. Thêm Ảnh chụp màn hình hoặc Animation vào GitHub Pull Requests
Quay lại branch bạn tạo trước đó và điều hướng đến "Pull requests". Ở đây, bạn có thể chỉnh sửa dữ liệu pull request từ menu ba chấm.
Một khi ở chế độ chỉnh sửa (editor mode), bạn có thể đính kèm file ảnh chụp màn hình và GIF animation từ tùy chọn "Attach files" (Đính kèm file). Nếu bạn commit lần đầu trong repository branch GitHub, nhấp "commit". Ngược lại, lựa chọn là "update comment" (cập nhật bình luận).
Ảnh chụp màn hình và animation đã tạo đã được thêm thành công vào branch GitHub, và lần lượt, repository.
GitHub toàn bộ là về cộng tác với các nhà phát triển khác. Nếu họ thích thay đổi bạn đề xuất, họ có thể merge (hợp nhất) nó upstream vào repository của họ. Điều này được thực hiện bằng tùy chọn "merge pull request".
Một animation chắc chắn là một cách tốt để thu hút sự chú ý của các nhà phát triển khác trong cộng đồng GitHub. Bằng cách hoàn thành hướng dẫn này, bạn đã học cách thêm ảnh chụp màn hình và GIF animation vào repository GitHub của bạn và bất kỳ branch nào của nó. Nếu bạn không quan tâm GitHub, bạn có thể xem danh sách các lựa chọn thay thế GitHub này.