Skip to content

Commit 1c6b8bf

Browse files
committed
add a section on source of truth. add a teaser for Github Sync. Ran a spellcheck.
1 parent 00ed5b4 commit 1c6b8bf

File tree

2 files changed

+19
-3
lines changed

2 files changed

+19
-3
lines changed

blog/2023-09-15-teams-feature-overview/index.mdx

Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Enter [Stately teams](https://stately.ai/docs/teams), our way to provide privacy
1919

2020
## Why would I need this?
2121
Great question, and we're glad you asked!
22-
While we have the [Discover](https://stately.ai/registry/discover) page, which showcases over 20 thousand(!) community-created machines, we know that statcharts can contain critical details about core algorithms or can have processes that give businesses a competitive edge.
22+
While we have the [Discover](https://stately.ai/registry/discover) page, which showcases over 20 thousand(!) community-created machines, we know that statecharts can contain critical details about core algorithms or can have processes that give businesses a competitive edge.
2323
Many users expressed interest in keeping these types of machines private, and we listened.
2424

2525

@@ -31,10 +31,10 @@ Teams is an exclusive feature for [**Pro** and Enterprise users](https://stately
3131

3232
### Access control
3333
There are many times when a dev team needs to share their work context with others without granting them full rights to the projects.
34-
For example, Lenny in accounting probably shouldn't have access to the company repo, but he could benefit from visually understanding the steps involved in processes and workfows.
34+
For example, Lenny in accounting probably shouldn't have access to the company repo, but he could benefit from visually understanding the steps involved in processes and workflows.
3535
Having different teams with different roles allows us to keep parties informed without added risk.
3636
Don't trust your PM's trigger finger? Make them a [viewer](https://stately.ai/docs/teams#viewer-role); we promise not to tell.
37-
Taking a vacation before new members can be onboared?
37+
Taking a vacation before new members can be onboarded?
3838
Make another teammate an [admin](https://stately.ai/docs/teams#admin-role).
3939
Checkout all our roles and permissions in our [docs](https://stately.ai/docs/teams#team-roles).
4040

@@ -44,6 +44,22 @@ Users can make their projects and machines public, but that is a no-go for most
4444
Alternatively, Pro users could keep their projects private and only share with people they trust by exporting and re-importing. However, that invites potentially different sources of truth, adds potential confusion, and lacks a truly shared context.
4545
Inviting users to collaborate on the same private team grants them the ability to share without the exporting and copy/paste gymnastics.
4646

47+
### A source of what, now?
48+
Simply put, a "source of truth" is a single place where all the information about a project is stored.
49+
In our case, we wanted to make sure that teams have a single place to view and collaborate on machine visualizations, and that place is a team-based project in the Studio.
50+
This prevents confusion and allows for a shared context between all members of the team. With a proper source of truth configured, we can avoid situations like this:
51+
52+
![true misery](/blog/2023-09-15-file-confusion.png)
53+
54+
55+
56+
### But what about source control? Shouldn't that be the source of truth?
57+
Ideally, yes, the team's repository is the single source of truth for all application logic, but not every member of the team is a developer, nor should they all have access to source code.
58+
That said, we know teams need to ensure their machines in the Studio are always in lockstep with the rest of their source, so we added the ability to [import machines directly from GitHub](https://stately.ai/docs/import-from-github).
59+
We're also working on a full-fledged GitHub Sync feature, allowing users to save machines as commits back to their source repos, so stay tuned for that announcement!
60+
61+
62+
4763
### Superpower Pro features
4864
Having teams allows other features to shine. For example, we all know the value of collaboration, but more users naturally add more potential for mistakes to happen, even with proper roles assigned. To protect against mistakes, we've added the ability to [lock machines](https://stately.ai/docs/lock-machines), preventing teammates from accidentally overwriting or deleting machines.
4965

52.9 KB
Loading

0 commit comments

Comments
 (0)