Tagged Questions
1
vote
1answer
144 views
As an lone, Agile (PXP/PSP) developer what is the proper structure for a formal project post-mortem? [closed]
Question:
As an lone, Agile (PXP/PSP) developer what is the proper structure for a formal project post-mortem?
Scenario
I'm using a PXP methodology (which is a blend of extreme programming and the ...
3
votes
2answers
183 views
How do you validate need for documentation?
I once was on a project where a non-tech manager had the team spending half of every hour documenting what they just did so that someone with zero understanding of the tech would be able to understand ...
13
votes
5answers
6k views
Design documents as part of Agile
At my workplace, we face a challenge in that "agile" too often has meant "vague requirements, bad acceptance criteria, good luck!" We're trying to address that, as a general improvement effort.
So, ...
3
votes
3answers
613 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 ...
11
votes
7answers
476 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 ...
2
votes
4answers
2k 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 ...
9
votes
6answers
479 views
How to use unit tests as a source of information?
A colleague of mine was once at a seminar about agile development, where he heard it is possible to use unit tests as technical documentation. Something like using unit tests as an example of how to ...
15
votes
7answers
810 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 ...
6
votes
1answer
135 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, ...
6
votes
2answers
207 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 ...
10
votes
5answers
2k 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 ...
3
votes
3answers
6k 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 ...
7
votes
4answers
301 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 ...
10
votes
6answers
636 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 ...
4
votes
5answers
2k views
How do you balance documentation requirements with Agile developments [duplicate]
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
2answers
266 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 ...
10
votes
5answers
489 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, ...
