Collaboration
How to collaborate with your team using Kiln
Last updated
How to collaborate with your team using Kiln
Last updated
It's easy to collaborate with Kiln across teams with technical team members (devs, data-scientists), and non-technical team members (subject-matter experts, QA, labelers, etc).
We suggest Git for technical teams, shared drives for non-technical teams, or a mix for mixed teams.
Kiln projects are simply a folder of files, making it easy to share them using Git. Add your project folder(s) to a git repo and you're set up with an excellent collaboration workflow with branches, pull requests, version control, access control, and more!
See below for how our file format is optimized for Git-based workflows.
Not everyone is familiar with Git, and that's okay! Since Kiln projects are just a folder of files, you can share the folder with your team using a shared drive of your choice (Google Drive, Dropbox, iCloud, etc).
Kiln project files will track who created them (internally in their JSON), which adds version history when many folks are making changes on the same shared drive.
You can combine both approaches for teams with a mix of technical backgrounds. Setup Git for technical team members, then host a branch on the shared drive for non-technical team members.
A technical team member can merge changes from the shared drive branch into main on occasion.
As you may have already guessed, you don't need to allow a third party to access your data, or maintain a database. Everything runs locally on your machine, and syncs through existing tools you control.
Kiln's data structure was designed with collaboration in mind:
A Kiln project is simply a folder of files, which makes it compatible with a range of existing collaboration tools, from Git to Dropbox
New items use unique random IDs to avoid conflicts/collisions, allowing many people to work concurrently on the same project.
Projects files are kept small and predominantly append-only. It's rare multiple people will need to work on the same file at the same time, reducing conflicts.
The Kiln project files are JSON files, and are formatted to be easily used with diff tools and standard PR tools (GitHub, GitLab, etc).
Static paths: even when changing the name of resource, the path will remain static.
