flutter.engineering Documentation
This page focuses on documenting development as done with the flutter.engineering team. This follows best practices as known in 2024. Agile software development has been embraced by customers for being straight forward giving developers some freedom, get things done and delivere fast. It is fair to say, that the agile development approach works well for skilled developers, who can estimate development time easily and know how to implement a software right away. It does not work for blackboxes, special software, commissioned work, also software that includes specialists for maintainance. Financial security is important for investors, contracts have to be made on a transparent bases, therefore software specifications, documentation, a classic waterfall model is more efficient and reliable for a SDLC. It reduces communication and gives developers a solid frame to rely on.
Maintainability, reliability, stability, security, data integrity, performance, all these domains matter and need quality assurance. The dart and flutter eco system enforces a solid source quality. Ensuring good documentation is beneficial for all parties even though it may extend the overall development time.
The documentation found here is ment to be primarily for developers. If you found what you are looking for as a developer, then be happy!
Documentation Software
/** Who is actually using it? **/
Development software itself has a history; Doxygen, DocBook, LaTex, Markdown, even specially developed XML-schemas for documentation. There is quite a high demand on having cutting edge documentation or user guides.
So documentation of course depends on the standard used in a company. Large companies with subcompanies will most likely have a schema including a corporate design, which will then be transformed for data interchange.