Following are the suggested guidelines that can be used for the design across tracks
- Each track should create a page under the use case flows page. The page should contain the following contents
- Sequence diagram for each workflow that will be realized under the track.
- Interface details which will be derived from the sequence diagram(easier for the designers to identify the touchpoints and corresponding APIs)
- Component level impact and functionality for each flow. This can also be derived from the sequence diagram.
- All API documentation should come under the corresponding project's page. (This will avoid the redundant info across the wiki pages which in turn will avoid any misalignment)
- Once, the API documentation is finalized, the swagger doc in the repo must be updated to match the API docs in the wiki. (All the developers can agree to use the swagger doc as the point of reference because it is being tracked by a version control system).
- The component impacts must be agreed with the PTL. (to avoid any confusions during the development)