What sort of technical documentation should be there while planing a large level web application? Like if need to develop a web application using the microservices architecture then we can think about the following documents in planing: 1. Flow charts 2. DFD & 3. Microservices Structure But, when we think about the complete technical management of a product then we also need to think about these things: 1. Change management 2. Technology selection 3. Server infrastructure 4. POC of different stack and approach So, the only Flow Charts & DFD are not sufficient I think. Anyone here can help to think this on a broad level like how to plan for the next 5-10 years today.

2.8k viewscircle icon3 Upvotescircle icon4 Comments
Sort by:
CTO in Software5 years ago

Start with a high level design document that outlines both the *how* and *why* of the application. From that create Milestones, Epics, and Stories that give Developers clear deliverables. For microservices architectures, or any that involve API endpoints, use a tool such as Swagger to keep APIs well documented and understandable by all.

Lightbulb on1
Director Certifications in Education5 years ago

Security requirements throughout the SDLC process (planning to implementation/maintenance).

Lightbulb on1
Group Chief Information Officer in Construction5 years ago

There are no particular standard for documentation sets
What is more important is to follow best practices in development with proper comments and well organised code structure

1 Reply
no title5 years ago

Yes, to an extent you are right that we can not just write down a simple process of documentation for all kind of software and application as it depends on the complexity and category of software.<br><br>But, I am just looking for an idea about planning a big web application. Like what sort of things can be there to think or draw before initiating the development, so that we can ensure the stability of product for next 4-5 years in terms for technology, feasibility, expand or scale the structure etc.

Content you might like

Collaborative problem-solving (facilitated discussions, shared goals) 25%

Structured governance (clear roles, escalation paths) 75%

Empathy and active listening (understanding business pain points)

Data-driven mediation (using evidence to guide decisions)

No, none of these

View Results

Cloud risk management26%

Cloud security architecture methods36%

Business architecture35%

Cloud security frameworks & best practices34%

Business relationship management15%

Strategic planning17%

Political navigation21%

Privacy advocacy11%

Native curated security9%

Cloud DevSecOps26%

Container service security19%

Cloud IAM patterns21%

IaaS/PaaS/SaaS security deployments7%

Native cloud security tools9%

CASB, cloud workload protection platforms (CWPPs) and cloud security posture management (CSPM) capabilities13%

Cloud WAF/CDN/DDoS services7%

Hypervisor security5%

View Results