2009-02-10 32 views
11

Trong một câu trả lời cho câu hỏi Documents for a project?, Chris Ballance trả lời rằng "User Stories" and a "burndown chart" are the two most useful types of project documentation for a developer.Ví dụ cụ thể về tài liệu Agile?

Câu hỏi của tôi là, bạn có biết của bất kỳ ví dụ tốt [s], mà tôi có thể nhìn thấy (ví dụ trên internet, hoặc trong một cuốn sách), của các loại tài liệu này?

Nếu có thể tôi muốn được vui mừng khi thấy nhiều ví dụ, bao gồm:

  • nhỏ/ngắn ví dụ/đơn giản
  • Big/dài/ví dụ phức tạp
  • ví dụ nổi tiếng
  • chất lượng cao ví dụ

Tôi không tìm thấy chủ đề này dễ dàng với Google cho: Tôi tìm thấy rất nhiều bài viết về nó, nhưng ít minh chứng hơn cho thấy tôi t.

Trả lời

6

Một nơi rất tốt để bắt đầu theo như sách có liên quan là User Stories AppliedAgile Estimation and Planning cả bởi Mike Cohn. Điều này có các ví dụ tuyệt vời và điểm khởi đầu tốt cho bất cứ ai đầu tiên đến phương pháp nhanh nhẹn.

Theo như tài nguyên trang web, chúng ít và xa. Có lẽ một nơi tốt để thực sự bắt đầu sẽ được tìm kiếm cho những từ khóa trên Google Images như nhiều người chụp ảnh của bảng xếp hạng burndown của họ và Câu chuyện của người dùng. Điều này đã giúp tôi rất nhiều khi bắt đầu. Dưới đây là một số mẫu: Burndown ChartUser Stories

Xin lưu ý rằng trong khi biểu đồ burndown là một báo cáo đơn giản mà bạn chạy trên các điểm câu chuyện hiện tại của bạn trong một lần lặp lại, Câu chuyện của người dùng phức tạp hơn và yêu cầu một chút đọc để quấn đầu của bạn xung quanh. Bắt đầu với Câu chuyện của người dùng Cuốn sách được áp dụng cho điều đó.

Hy vọng điều đó sẽ hữu ích!

+0

Tôi ngạc nhiên khi biết rằng "tài nguyên trang web ít và xa": các loại tài liệu này không được sử dụng trong thực tế, bởi "nhóm ảo" (tức là nhà phát triển phân tán địa lý) phát triển nguồn mở (tức là công khai) dự án? Nếu không, bạn có thể suy đoán là tại sao không? – ChrisW

+0

Tôi thực sự làm việc trên một đội ngũ nhanh nhẹn từ xa và tất nhiên chúng tôi sử dụng các công cụ từ xa, tôi nghĩ bạn có nghĩa là từ một khía cạnh của học tập nhanh nhẹn. Đối với các công cụ ảo, bạn có các tùy chọn như Acunote, TargetProcess, Unfuddle. Những công cụ này rất hữu ích cho các nhóm từ xa nhưng không nên thay thế một bảng nút chai khi có thể. –

+0

Vì vậy, tôi nghĩ bạn đang nói rằng những câu chuyện của người dùng, vv * được * sử dụng bởi các nhóm ảo; nhưng, chúng có xu hướng không ở trên các trang web, bởi vì thay vào đó chúng được tác giả sử dụng các công cụ [như những trang bạn đã trích dẫn] khác với web? – ChrisW

0

Cân nhắc đọc "Mô hình Agile" của Ambler. Anh ấy tạo ra một trường hợp rất mạnh mẽ là tại sao chỉ tạo ra hàng tấn UML đầy đủ là một ý tưởng khá tồi, và đưa ra một số ví dụ tốt.

+0

Giải thích lý do tại sao không tạo ra tấn UML sẽ không phải là câu trả lời cho câu hỏi của tôi. – ChrisW

+0

Xin lỗi, tôi không có thời gian để viết bất cứ điều gì hoàn chỉnh hơn, chủ yếu là muốn giới thiệu bạn đến với cuốn sách. Anh ta thảo luận về các lựa chọn thay thế của mình để sử dụng các trường hợp và điều quan trọng là phải nắm bắt. – Uri

1

Một vài tháng trước, chúng tôi bắt đầu viết tài liệu người dùng cùng một lúc khi chúng tôi đang phát triển các tính năng. Một nhà văn kỹ thuật được giao cho mỗi đội Scrum.

Phải viết tài liệu người dùng trong khi phát triển giúp xác thực thiết kế. Các nhà văn kỹ thuật cũng tham gia vào việc thiết kế các ứng dụng.

Đây là ngoài việc phát hành burndown và sprint burndown.

Tài liệu bổ sung được tạo bởi nhóm khi họ cảm thấy hữu ích khi giao tiếp với chủ sở hữu sản phẩm. Điều này trở nên kém quan trọng vì chúng tôi đang học cách viết những câu chuyện của người dùng tốt hơn.

+0

Tôi luôn nghĩ rằng một đặc tả chức năng là tài liệu hữu ích nhất. Tài liệu người dùng là một lớp con của đặc tả chức năng, IMO. Vì vậy, nếu bạn đang nói rằng tài liệu người dùng là đủ, và rằng nó là tốt để phát triển nó trước và/hoặc với phần mềm, tôi thấy rằng chính đáng. – ChrisW

+0

Trên thực tế, tài liệu người dùng có thể là đủ cho các nhà phát triển ("chúng tôi đang xây dựng chức năng người dùng cuối") nhưng có thể không gây khó khăn cho người quản lý dự án ("đang làm gì * trong lần chạy nước rút * này") và ngược lại chức năng ưu tiên thấp hơn được phân loại và bị bỏ qua ít nhất cho đến lần sau? "). – ChrisW

3

Tôi nghĩ cho cả hai câu hỏi này, bạn có thể làm tồi tệ hơn nhiều so với quét trên trang web của Alistair Cockburn. Đặc biệt, ông có một bài viết tuyệt vời về bảng xếp hạng burndown và một số cách khác nhau để tạo ra chúng:

http://alistair.cockburn.us/Earned-value+and+burn+charts

(thoug Tôi xin nhắc lại khuyến cáo các poster trước đó của công việc Mike Cohn của).

Một trong các thủ thuật là quyết định loại tài liệu nào tốt cho dự án CỦA BẠN. Bạn có nhiều nhà phát triển, trải rộng theo thời gian và không gian? Bạn sẽ cần những câu chuyện lớn hơn, nặng hơn, chi tiết hơn. Bạn có một hoặc hai nhà phát triển làm việc ở cùng một địa điểm không? Bạn có thể lấy đi với những cái nhẹ hơn. Nhóm đã làm việc trong hệ thống (nếu nó là di sản) trong một thời gian dài? Những câu chuyện nhẹ có lẽ sẽ làm. Là nhóm mới cho hệ thống, hoặc là phức tạp yêu cầu kinh doanh của nó? Điều này đẩy bạn theo hướng chi tiết hơn.

Nếu bạn đang ở trên một dự án "nhỏ" theo bất kỳ định nghĩa tá nhỏ, bạn có thể tốt với những câu chuyện rất nhẹ. Dưới đây là một ví dụ, một lần nữa từ trang web Cockburn của:

http://alistair.cockburn.us/Examples+of+ultra-light+use+cases

Các vấn đề liên quan