Dự án bị đóng băng - tôi nên để lại gì cho những người sau tôi?


14

Vì vậy, dự án tôi đang thực hiện hiện đang bị đóng băng vô thời hạn. Có thể là nếu và khi dự án mở ra một lần nữa, nó sẽ không được chỉ định cho tôi hoặc bất kỳ ai trong nhóm hiện tại. Trên thực tế, chúng tôi đã kế thừa dự án sau khi nó bị đóng băng trước đó, nhưng nhóm trước đó không còn gì để giúp chúng tôi hiểu ngay cả những nhu cầu cơ bản của dự án, vì vậy chúng tôi đã lãng phí rất nhiều thời gian để tìm hiểu rõ về dự án. Câu hỏi của tôi là bạn nghĩ chúng ta nên làm gì để giúp những người sau chúng ta hiểu rõ nhất về nhu cầu của dự án, những gì chúng ta đã làm, tại sao chúng ta đã làm nó, v.v. Tôi cởi mở với những ý tưởng khác về lý do tại sao chúng ta nên rời đi một số bài hát cho những người khác cũng sẽ làm việc trong dự án này.

Một số bước chúng tôi đã thực hiện:

  • tài liệu kỹ thuật (không đầy đủ nhưng ít nhất là có một số);
  • lịch sử hệ thống kiểm soát nguồn;
  • ước tính về phần nào của dự án cần cải thiện và tại sao chúng tôi nghĩ như vậy;
  • bó bài kiểm tra đơn vị.
  • theo dõi vấn đề với tất cả các vé chúng tôi đã thực hiện ( EDIT )

Bạn nghĩ gì về những gì chúng ta đã chuẩn bị và chúng ta có thể làm gì khác?


2
xem xét danh sách vé dễ lấy trong bộ theo dõi vấn đề liên quan đến dự án
gnat

1
Càng nhiều câu trả lời của "Tại sao?" Trong README.TXT với các nguồn dự án càng tốt.

@gnat cảm ơn vì ý tưởng. Nó nhắc tôi rằng tôi quên đề cập đến nó. Chúng tôi sử dụng theo dõi vấn đề với tất cả các vé. Tôi sẽ thêm nó vào danh sách.
nyxz

1
Tôi đang rơi một giọt nước mắt đoàn kết cho cơ sở mã bị bỏ rơi của bạn. zdnet.com/blog/projectfailures/ từ
Ben DeMott

Câu trả lời:


9

Một số điều nữa để xem xét

  • Là cấu trúc thư mục dự án lành mạnh? Bạn đã sửa đổi các ý kiến ​​mã? Là bản ghi cam kết bằng cách nào đó có thể trình bày?
  • Tổng quan về mục đích của Gerneral (trái ngược với kỹ thuật mà bạn đã bắt đầu), Nên đọc về dự án, lịch sử dự án (chu kỳ phát triển của nó, người quản lý dự án trước đó, danh sách nhân viên, yêu cầu / đặc điểm kỹ thuật)
  • Sơ đồ UML, sơ đồ lớp, sơ đồ dòng công việc!
  • Lý do dự án đã bị đóng băng luôn luôn tốt đẹp.
  • Môi trường phát triển, các IDE đã được sử dụng, xây dựng các công cụ, chúng được đề cập trong các tài liệu kỹ thuật phải không?

Tôi chỉ nghĩ về một số điều tôi muốn thấy trong một dự án mà tôi mới kế thừa. Những gì bạn đã cung cấp là một địa ngục nhiều hơn những gì tôi nhận được. Bạn sẽ nhận được điểm nghiệp lực lớn để giúp đội tiếp theo ra ngoài :)


8

Những điều tôi muốn có khi chọn một dự án mà người khác đã đặt ra là:

Xây dựng hướng dẫn, bao gồm các phiên bản làm việc được biết đến cuối cùng của tất cả các công cụ trong chuỗi công cụ. Trình biên dịch, IDE, v.v ... thay đổi theo thời gian và sẽ dễ dàng hơn để làm việc nếu các nhà phát triển trước để lại cho tôi hướng dẫn về cách thức chạy và chạy.

Chạy hướng dẫn môi trường - những gì cần phải có để chạy thứ này? Một đề cập về những phiên bản là một lần nữa hữu ích. Gần đây tôi đã chọn một cái gì đó yêu cầu một tập tin nhất định phải ở một nơi nhất định và tôi phải đi hỏi các nhà phát triển khác để tìm ra nó. Không phải là một vấn đề lớn vì các nhà phát triển khác đã có sẵn, nhưng nếu anh ta không có, thì nó sẽ có vấn đề.

Một số đảm bảo rằng mã cam kết với kho lưu trữ thực sự kiểm tra và xây dựng. Tôi đã từng chọn một dự án nơi các nhà phát triển trước đó (may mắn là vẫn còn ở đó) đã thực hiện một số điều thực sự kỳ lạ với Makefiles để bạn không thể xây dựng dự án từ thanh toán sạch. Không cần phải nói, trước tiên tôi phải điều chỉnh RATNG trước khi tôi thực sự có thể làm bất kỳ công việc nào. Nếu các nhà phát triển trước không có sẵn, có thể mất nhiều thời gian hơn để vượt qua rào cản đó.

Một tuyên bố chung về ý định của dự án. Phần mềm này để làm gì? Càng ngắn càng hợp lý, nhưng một số loại tổng quan có thể thực sự hữu ích.


+1 cho chuỗi công cụ hoàn chỉnh. Tất cả tài liệu trên thế giới sẽ không hữu ích nếu bạn không thể xây dựng và kiểm tra phần mềm. Khi có thể, tôi muốn bao gồm các hình ảnh cài đặt cho tất cả các công cụ (mặc dù hiện tại tôi có thể chọn một hình ảnh VM nào đó). Không có gì tệ hơn là tìm ra quy trình xây dựng phụ thuộc vào trình cắm của bên thứ ba từ một công ty không còn tồn tại nữa!
TMN

@TMN - và đó là lý do tại sao tôi có xu hướng né tránh những thứ như plugin IDE thương mại, v.v. Tôi không tin tưởng rằng tôi sẽ có thể tái tạo môi trường của mình sau này. Và đã làm việc trên phần mềm hơn 20 năm tuổi, tôi KHÔNG BAO GIỜ cho rằng mọi thứ sẽ biến mất.
Michael Kohne

4

Một màn hình

Khi tôi rời bỏ công việc cuối cùng của mình, tôi thực sự đã thực hiện các screencasts chưa được chỉnh sửa, từ những gì tôi đã nghe, rất hữu ích trong việc đưa người mới lên tàu. Tôi đưa nhóm của mình vào một căn phòng, thiết lập mic ngưng tụ và giải thích cho họ mọi thứ tôi biết về dự án trong khi ghi lại âm thanh và màn hình. Sau đó, tôi để họ hỏi tôi những câu hỏi về nó. Chúng tôi có thể thu được nhiều thông tin hơn mức có thể nếu tôi ngồi xuống và cố gắng gõ nhanh nhất có thể cả ngày.


+1 Điều này rất đơn giản, nhưng làm cho SO có nhiều ý nghĩa.
lwm

2

Nếu bạn là người kín đáo với thông tin, hãy thêm Yêu cầu kinh doanh.

  1. Khách hàng muốn gì?
  2. Làm thế nào những thay đổi tạo điều kiện cho điều đó?
  3. Một số thách thức trong việc đáp ứng nhu cầu của khách hàng là gì?
  4. Nhu cầu nào không được đáp ứng và tại sao?

1

Một hình ảnh máy ảo (tức là vm-ware) của một hệ thống phát triển độc lập đang chạy có thể khá có giá trị.

Năm ngoái tôi đã được yêu cầu sửa một số mã vb3. Nó khá là khó khăn khi tạo lại một hệ thống đang chạy với vb3, windows95 và rất nhiều ole-kiểm soát được cài đặt. Sau một tuần tôi đã từ bỏ :-(

[Cập nhật] Có ai có kinh nghiệm với việc chuyển đổi hình ảnh máy ảo cũ để có thể phát nó trong trình phát máy ảo mới hơn không?

Bạn cũng phải xem xét rằng có thể không còn có thể chạy một hình ảnh rất cũ trên hệ điều hành / phần cứng hiện đại.


Xem xét mở một câu hỏi mới về nâng cấp máy ảo.

@ Thorbjørn Ravn Andersen. Bạn đúng rồi. Tôi đã điều chỉnh phần cuối của câu trả lời của tôi.
k3b
Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.