How do you document the design environment?

almost 2 years ago from Jason Spidle, Full Stack Designer

  • Andrew CiobanasiuAndrew Ciobanasiu, almost 2 years ago

    I had a similar post a few months back.

    Definitely some helpful suggestions there. I did a lot of research and analysis of options for us.

    Ultimately I decided to create a repo in our company Gitlab instance and maintain a wiki there. Easy to manage, developers are comfortable with it already, didn't require another tool or account, free, and while not the sexiest new thing, it works for our crew. Here, I have things like recommended plugins, artboard layout and structure (with examples), naming conventions for layers, export and slicing best practices, and so on.

    As for versioning, we use Sketch and Abstract. Abstract has been truly wonderful to use, even with only one designer. I am still working out the details of applying semantic versioning to design files. I found Nathan Curtis' Medium post on the topic to be particularly useful. He dives into a few things you are mentioning regarding versioning.

    Edit: Doh. You literally suggested some of the products in the thread I posted earlier. I'm blaming this on Friday brain.

    6 points
    • Jason Spidle, almost 2 years ago

      No worries, that was definitely a useful post with some overlap. That Nathan Curtis post seems super useful and I definitely have been eyeing Abstract. The more people encourage it, the easier it might be to convince everyone else. I just wonder how easy or effective it will be trying to convince other designers on my team to make commits and pushes, etc.

      1 point