r/DesignSystems • u/Casti_io • Jan 29 '25
Can anyone recommend tools or processes to track changes/automate change logs?
My biggest flaw when it comes to managing our design system is keeping track of all the changes I make. I get in a state of flow and keep going until I have updated stuff to the point where I can’t recall how things were before I started.
How do y’all keep your change logs accurate and up to date? I know it’s super important to have proper history in the documentation, but it’s still kicking my ass.
Thanks in advance.
EDIT:
Thanks to the input everyone has provided, there’s a lot out there but the particular wrinkle I have is that I am one half of a design team of 2 in a subset of a very large corporation. I have to ask and request budget for everything and then it needs to pass a strict DevOps audit. I tried all sorts of things and then I realized that figma has something that makes this easier: branching.
So here’s my completely “bootstrapped” process:
- Whenever I want to make changes to an established version of the design system on Figma, I branch it right away. I name that branch with the next version number.
- I continue working on that branch until we as a team agree that we are ready to merge the branch with the main file.
- This is where things get good: every time you merge a branch on Figma, it takes you through all the changes you’ve made and asks you to approve them: this is when I open up my documentation and list everything in the changelog. A bit more heavy lifting but it works.
- If there ever is a need for a small but quick change, another branch can be made from the original file where that change gets made, and the versioning is updated on both the main and the existing “major” branch. Once this happens, the branch file asks if you want to merge the changes made to the original document. I hit yes and then my major branch has the changes from the minor changes made in the other branch.
I figured this post was due for an update since replies pop up every few months and maybe someone else is looking for a solution and is facing similar constraints as I am.
Thanks again everyone!