Всем привет
Предлагаю обсудить в етой ветке темплайты для следуюших типов документов:
1. Use-Case
2. SAD - Software Architecture Document
3. Low Level design document.
4. Project Plan document
сразу оговарюсь, это для работы на иностранного заказчика, в оффшорных проектах
Разработка может идти по какой угодно методологии, RUP, 4+1, etc
Для каждого типа документа определим его структуру, формат представления данных, уровень детализации и что же все-таки в нем писать.

Готов делится рельными примерами документов в private.

AlexTheRaven
SRS, Software Requirements Specification, специально забыли? :)

Хех,
в моем представлении (возможно ушербном) Requirements model это:
I. Functional Requirements
II. Non-Functional Requirements

1. Functional Requirements
Functional requirements depict the functions that the client expects to be able to perform within the solution.
2. Non-Functional Requirements
Non-functional requirements can be broken down into the following 2nd level packages:
 Business requirements;
 User Interface requirements;
 Hardware requirements;
 Software requirements;
 Performance requirements;
 Security requirements.

3. Business requirements
These requirements describe needs of the customer which are not directly linked to any particular functions of the solution but describe a business objective or objectives which must be achieved as a result of the system being developed.

4. User Interface Requirements
User interface requirements described how the customer would expect the solution to interact with the users of the system.

5. Hardware Requirements
Hardware requirements describe the hardware which will be available to be utilised by the application in order to achieve the solution objectives. This type of requirements is very closely related to the performance requirements.

6. Software Requirements
Software Requirements describe the various software needs of the solution such as operating system, browsers to be used, protocols, third party software etc…

7. Performance Requirements
Performance requirements describe the expectations that the customer has in terms of how the solution will perform under specified conditions.

8. Security requirements
Security Requirements defines system access levels and data protection requirements. Desired security expectations should be described at both hardware (net topology, firewalls etc.) and software (checks, constraints, validations etc) levels.

AlexTheRaven
Самое простое - берёте RUPовский шаблон, и выкидываете оттуда всю муть, кроме некоторых названий разделов.

Метод хорош, но для меня не приемлем

AlexTheRaven
И начинаете писать, но только до тех пор, пока есть что написать, или до тех пор, пока в документе не станет 30 страниц.

30 страниц мало , интересует от 150 и выше :-)

AlexTheRaven
Low Level design document - IMHO пишется на языке программирования :)

Вот именно это и интересует в большей степени.
Скажем, при помощи каких методик Вы опишете следушее:
1. At the application level:
• Description of major components or packages of classes
• Which aspects of external packages / libraries that will be re-used

2. At a “package” / directory / namespace level:
• Class hierarchy / patterns
• Class interaction – how the classes co-operate to solve the problem

3. At a class level:
• Class description – including purpose of class
• Main usage scenarios
• Constraints and assumptions

4. At a function level (for all non-trivial functions, so don’t waste time documenting default constructor etc generated by the compiler)
• Function description
• Constraints and assumptions
• Private or Public?


Следует пояснить, я не прошу помощи, просто хотелось взглянуть на подобные документы, сделанные в других проектах.
В замен могу показать свои :-)