Drafts
Last updated
Was this helpful?
Last updated
Was this helpful?
Multiple drafts is only available for Growth plans
Drafts allow you to propose future changes to your architecture without affecting your current model and diagrams. The changes made in drafts live in isolation from other diagrams, meaning you won't affect other areas of the design until you merge the changes in. This is perfect for the design phase when you're unsure which direction to meet the business or product requests.
- 5 min
In software development, diagramming and documenting the current state of your architecture helps team members get up to speed with how things work today, but to progress, we need to propose future changes and discuss these decisions.
Communicating the future of our system(s) as a guide to get to our end goal helps everyone know what the direction of the team is and how we will technically meet the business needs. Even if the design changes over time (which of course it will), this can be a huge help to everyone understanding the technical journey the team will go on to achieve the goals of the business.
Drafts are scoped to a single diagram, so start from the diagram view you want to propose changes to.
In a diagram, select the Current pill under the diagram name at the top
Create a draft with the New draft diagram
Propose your changes by updating existing objects and relationships or adding new ones
Notice your changes are added to a count in the Review and merge button next to the draft pill. You can quickly glance at the proposed changes by hovering on the button or by clicking it to review the changes made as part of that Draft.
You can create many drafts on one diagram that helps you compare proposals with each other and your current design.
Once you've decided on the design you're moving forward with, you can merge the changes into your main model, updating objects and replacing the current diagram with the proposed one.
Click Review and merge
You'll see a list of everything that will be added, updated and removed as part of the merge.
Click Merge
It is possible you'll have conflicts in a draft version, making the change not possible.
Example: In a draft, you update a connection to a system that no longer exists in your current version. 🙅
We've simplified our conflict resolution process to stop any merging if a conflict arises. You will not be able to merge changes if there are conflicts.
The drafts and current versions of a diagram use the same camera position, meaning you can move from Current to Drafts of the design seamlessly.
Large interconnected changes are not recommended in drafts yet.
We recommend using separate landscapes if you are in the process of a huge architecture restructure, such as moving from monolithic to micro-service architecture or any "big vision" / "north star" architecture. You can duplicate a landscape to reduce duplication of work if some of the model objects still exist in the new design.
In IcePanel, you can design your future changes using Drafts, an option on a diagram to propose changes without affecting the current model. With Drafts, you can create design proposals starting from your current model, but the changes don't affect your current model until you merge these changes. Paired with to showcase your future version changes, you can show exactly where you're going separately from the current design.
Drafts also work with and , meaning you can show the effects on user flows based on the changes you're making, propose new flows and highlight technology, risk, cost etc. changes.
This currently deletes the other drafts you have in that diagram and replaces the current diagram, so make sure you first to keep these for reference later on.
Reach out to us if this happens:
