You are viewing a single thread.
View all comments View context
-1 points

Requirements ≠ Documentation.

They are part of documentation, but not all documentation.

permalink
report
parent
reply
1 point

The difference is in exact wording Agile: the software shall properly authticate a user within our active directory.

Documention : user authentication will be provided by functions ”valisate username” as described in section 14,7 subsection 4, ”validate password” as described in section 16.2 and validate the correct pasword as described in section 23.4.Proper authication to the correct use group shall comply with the requirements in document 654689 section 64.7 subsection 17

Yes there is a difference and one is better…

permalink
report
parent
reply
6 points

So you started with the need to authenticate, which should be documented in the requirements. You know, the things that are required to happen.

The details on HOW to authenticate are ALSO documentation. Not all documentation describes functionality.

permalink
report
parent
reply
4 points

If you need documentation then do documentation. Nothing in the agile methodology tells you not to.

permalink
report
parent
reply
2 points

So you started with the need to authenticate, which should be documented in the requirements. You know, the things that are required to happen.

I think you’re confusing documentation with specification.

Requirements are specified. They are the goals and the conditions in which they are met. Documentation just means paper trails on how things were designed and are expected to work.

Requirements drive the project. Documentation always lag behind the project.

permalink
report
parent
reply

Programming

!programming@programming.dev

Create post

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person’s post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you’re posting long videos try to add in some form of tldr for those who don’t want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev



Community stats

  • 3.9K

    Monthly active users

  • 1.7K

    Posts

  • 29K

    Comments