What I want to work out is with the various views of UML modelling BA principals and programming, are there set documentation template rules that can be used that are a standard within the UML/BA field? Ive looked through RUP standards which look good, in the SPARX website and also other resources but each seem to have their own set of rules...if UML is a standard why isn't documentation? Unless Im missing something??
There are two reasons no standard for documentation exists.
The first is that, until recently, there has been no body that was in a position to set standards for BA work. Right now, the
IIBA is working towards that goal. But you know, honestly, we're not going to
have a standard document template in our materials, and I can say that with complete confidence, because I'm the guy responsible for the standards on documentation.
The reason no standards exist now, or will in the near future, is that there are just too many damn methodologies out there, each of which requires its own set of documentation. Couple that with variation between projects and you get a mess. Most templates end up being designed for a very high level of detail and completeness that may not be appropriate for all projects.
Since we have to cover everything from mainframe COBOL green screen applications to nuclear safety systems to web development, we won't be imposing a standard either. Basically a documentation standard only makes sense if it fits into an overall development process.
There is an IEEE Standard requirements template, but it's not popular amongst OO types. The RUP template is OK and will probably get you by. If you want references let me know.