4 ms·
There should be a documentation system that suits the role of each job role, group, and company division. There should be something better than the landfill of
by greenyouse 7y ago
There should be a documentation system that suits the role of each job role, group, and company division. There should be something better than the landfill of data that are wikis or confluence.
Why can't there be a system that summarizes the details of apps based on README files or architecture files? Supporting documentation should be personalized to the user so if you're a developer you'll get API info and sequence diagrams (product managers could get product notes, etc.).
The documentation system should be alive with interactive examples that drive home what the experience is (embedded invision, web pages, swagger docs, etc.).
Documentation should be automatically deprecated as the state of your system and product change. Archives of old stuff could be kept for reference but the actual interactive system should be only live things so they're relevant.
Does this already exist?