Cập nhật readme của gatein source !

23 views
Skip to first unread message

Tuan Pham

unread,
Jul 28, 2013, 7:59:50 AM7/28/13
to mhst...@googlegroups.com
Dear Thịnh, 
hôm nay anh nhận được yêu cầu đánh giá dự án giữa kỳ, anh có vào xem code của mình ở đây 
có số việc anh nghĩ là em cần cập nhật lại 
Readme file nên update và đưa link google group vào làm official community forum cho dự án, đặt link cho phần tạo issue tron github (hoặc hostedredmine) để làm link report problem cho dự án
Qua xem code anh thấy mọi người chư config github để exclude các file project config , target ... ta cần đặt để git nó ignore các file đó đi, chỉ giữ lại source khi commit 
Cập nhật hướng dẫn cài đặt, hoặc hướng dẫn develop cho dự án để một người muốn tham gia và join có thể start luôn được không gặp phải khó khăn gì 
Anh sẽ test các module theo report trong http://www.hostedredmine.com/projects/mhst1304 và gửi feedback lại cho các bạn

p...@banphim.net

unread,
Aug 3, 2013, 3:09:41 AM8/3/13
to mhst...@googlegroups.com
Xin bổ sung thêm ý kiến của anh Tuân:
- File README là bộ mặt của dự án, hãy chăm chút cho nó. Đừng để xảy ra những lỗi như format sai, bố cục lộn xộn. Chỉ để những thông tin liên quan đến công nghệ! Đừng đưa những thông tin người ta không quan tâm vào. Nếu đã xác định dùng tiếng Anh thì nên nhất quán, tất cả commit message / comment và tên các thực thể trong code, cũng như tài liệu đều để tiếng Anh. Nếu cần thì tạo file README-vi.
- Không nên để file binary (trong trường hợp này là *.pdf) trong repo. Các scm chỉ quản lý được thay đổi trong nội dung file text nên dùng binary sẽ khiến kho mã nguồn phình ra không cần thiết. Thêm nữa là không nên coi tài liệu thiết kế là chân lý để rồi mất sự linh động cần thiết.
- Tham khảo các dự án nguồn mở trưởng thành để biết cách đặt tên các file tài liệu

P/s: có kha khá việc đấy nhỉ -> hãy tạo issue cho mỗi việc trước khi thực sự triển khai

khanhthinh

unread,
Aug 3, 2013, 11:48:03 AM8/3/13
to Hoàng Minh Thắng, MHST1304
Hi anh Thắng,
Em sẽ xem và điều chỉnh lại ạ.


Vào 16:09 Ngày 03 tháng 8 năm 2013, <p...@banphim.net> đã viết:

--
Bạn nhận được thư này vì bạn đã được đăng ký vào nhóm Google Groups "E-Learning GateIn System".
Để hủy đăng ký nhóm này và ngừng nhận email từ nhóm, hãy gửi email tới mhst1304+u...@googlegroups.com.
Để có thêm tùy chọn, hãy truy cập https://groups.google.com/groups/opt_out.





--
Nguyễn Khánh Thịnh
Ad: Đại Học Công Nghệ - Đại Học Quốc Gia Hà Nội
Tel: 0995 765 761 or 0974 471 742


Trên bước đường thành công la liệt dấu chân thất bại! Vì thế hãy sống với nhau bằng tư tưởng cùng thắng, đừng dẫm đạp lên nhau.

Hoàng Minh Thắng

unread,
Aug 3, 2013, 12:29:35 PM8/3/13
to khanhthinh, MHST1304
À quên một cái nữa là không nên nêu mail cá nhân cho việc tiếp nhận thông tin chung như thế, chỉ để một địa chỉ duy nhất là mailing-list thôi. Để thông tin vào mail cá nhân sẽ tăng thời gian bị delay không đáng có, chưa kể nhiều cái đầu thì tốt hơn một cái đầu.
Tất nhiên có ngoại lệ là báo lỗi bảo mật đặc biệt nghiêm trọng, nhưng nó không phải trường hợp này.

khanhthinh

unread,
Aug 3, 2013, 8:58:30 PM8/3/13
to Hoàng Minh Thắng, MHST1304
Vâng anh,
Tôi quá khi review em đã xóa email cá nhân ra khỏi README. Đó là di sản của lúc khởi động dự án chưa có mailling-list, nên giờ phải xóa đi là hợp lí ạ.


Vào 01:29 Ngày 04 tháng 8 năm 2013, Hoàng Minh Thắng <p...@banphim.net> đã viết:
À quên một cái nữa là không nên nêu mail cá nhân cho việc tiếp nhận thông tin chung như thế, chỉ để một địa chỉ duy nhất là mailing-list thôi. Để thông tin vào mail cá nhân sẽ tăng thời gian bị delay không đáng có, chưa kể nhiều cái đầu thì tốt hơn một cái đầu.
Tất nhiên có ngoại lệ là báo lỗi bảo mật đặc biệt nghiêm trọng, nhưng nó không phải trường hợp này.
--
Bạn nhận được thư này vì bạn đã được đăng ký vào nhóm Google Groups "E-Learning GateIn System".
Để hủy đăng ký nhóm này và ngừng nhận email từ nhóm, hãy gửi email tới mhst1304+u...@googlegroups.com.
Để có thêm tùy chọn, hãy truy cập https://groups.google.com/groups/opt_out.


Reply all
Reply to author
Forward
0 new messages