Ideal TK

Question

Preparation of terms of reference

Gentlemen, perhaps you have examples of ideal TK? Who are very good to work with? What is it? What is its integral part?
Share!

Answer 1

This does not exist :-)
More precisely, there is no general solution for all cases.
In general, there is such a document.

Answer 2

Tz is ideal if the performers understand what you want to get at the end.

Answer 3

Well, firstly, I think that you certainly know about agile and other “agile” development methodologies - in this case, detailed technical specifications are absent at all (user stories, sketches, etc. are used) - see, for example , 6 reasons why you you should not write functional specifications and a lot of similar materials on Habré
Secondly, as for the structure of the document proposed by GOST - in my experience it is not very convenient - you still need to call a spade a spade.
It is better to divide all this into several documents:
- envisioning (concept) - a generalized document that tells what, why and by what forces / means we want to achieve
- functional specification (as a rule, this is called TK) - what the system should actually do, how it should look, etc.
- technical specification (if necessary) - this document is mainly for the developers themselves, but can be used to coordinate the use of frameworks, DBMS, etc.
- if the project can be divided into blocks, there can be several specifications - of each block.
In specifications, as a rule, UML diagrams are used (but again, on Habré, some people think that “UML is dead”).
In general, the main idea of ​​​​the specification is that the customer and the contractor speak the same language (see ubiquitous language in the Domain Driven Design concept ) and equally understand what needs to be done.
Good luck with this difficult task :)

Answer 4

For about five years I have been using mental maps to compile technical specifications
. This is much more convenient than compiling a multi-page document, which is then difficult to keep up to date and which is impossible to navigate.
Clients are happy, programmers are happy, as a project manager I am simply delighted :)
Here is an example of such a TK in the public domain from the mindmeister.com service
I myself use MindJet MindManager Pro and its online version