Tagged Questions
12
votes
7answers
447 views
How can Scrum be adapted to an academic environment?
I'm currently working with a professor at my university to develop new curricula for the Software Engineering and Capstone Design courses offered in my college.
Up until recently, both courses used ...
11
votes
7answers
559 views
Does it make me a bad programmer if I dislike the Agile methodology? [closed]
I like the small iterations. I like the unit tests. I like code review. What I don't like is the starting off with little or no documentation. Am I alone in this? Do I simply have a ...
11
votes
7answers
420 views
Documentation degrading - how to deal with it?
Important: we have no issues whatsoever with source code documentation. This belongs to regular code audit and is kept up to date. Our problem is with developers documentation (or, "external" if you ...
9
votes
5answers
781 views
Is it a good idea to write requirements specifications by stories?
We're using agile methods in my current project at the moment, and we have heaps of stories like these:
As an assistant, I want to pay a customer a refund so that they can
get some money when they ...
8
votes
5answers
402 views
Is an architecture description document a violation of the DRY Principle?
The DRY Principle (Don't Repeat Yourself) states that "every piece of knowledge must have a single, unambiguous, authoritative representation within a system." Most of the time this refers to code, ...
7
votes
5answers
254 views
How to use unit tests as a source of information?
A colleague of mine was one a seminar about agile development, where he heard it is possible to use unit tests as a technical documentation. Something like using unit tests as example how to use the ...
7
votes
4answers
222 views
Should all developers on a team have equal role/responsibility in writing and updating software design documents
I've asked a very similar question few days ago, but because I presented too much of my company's current situation, most answers focused completely on something that I wasn't looking to answer. So I ...
6
votes
1answer
113 views
How to change documentation expectations from “risk management” to a “project risk”
We are trying to introduce some agile concepts to the business folks but one of our biggest hurdles is their expectations for documentation - the quantity, the authorship/ownership of the documents, ...
5
votes
2answers
138 views
How do you track existing requirements over time?
I'm a software engineer working on a complex, ongoing website. It has a lot of moving parts and a small team of UI designers and business folks adding new features and tweaking old ones. Over the last ...
3
votes
3answers
378 views
Extreme Programming - documenting implementation?
In extreme programming methodology, what artifacts/ can be used to document the implementation?
I have used an activity diagram to document the design steps for each activity. I have read that for ...
3
votes
5answers
680 views
How do you balance documentation requirements with Agile developments
In our development group there is currently discussions around agile and waterfal methodology. No-one has any practical experience with agile, but we are doing some reading.
The agile manifesto ...
3
votes
3answers
3k views
Are High Level Design and Low Level Design documents needed to follow Agile development process?
Our team is developing a project using an Agile development process. All of our requirements are converted into product backlog items and task are broken down based on that. One of my team member ...
2
votes
4answers
548 views
How to properly document functionality in an agile project?
So recently, we've just finished the first phase of our project.
We used agile with fortnightly sprints. And whilst the application turned out well, we're now turning our eyes on some of the ...
2
votes
2answers
223 views
Support / Maintenance documentation for development team
I'm working in the Development dept (around 40 developers) for a large E-Commerce company. We've grown quickly but have not evolved very well in the field of documenting our work. We work with an ...
