Overview of Content Sharing

Teams often want to set up a base of documents that can shared with the whole team. This is done by creating organizations, adding mount points that are owned by that organization, and then granting permissions to groups of people within the organization.

Creating Organizations

An "organization" is a special type of user within a given OpenSquiggly instance.

Managing Organization Members

From the "Manage Organizations" accordion in the "User Option" form, click the "Manage Members" button.

Managing External Connections

As discussed in the chapters "Mounting Source Code Repositories" and "Mounting Documentation Repositories", an external connection is used to store the credentials needed to clone a private repository in a Git repository, namely, Azure DevOps, Bitbucket, GitHub, or GitLab.

Managing Mount Points

As discussed in the chapters "Mounting Source Code Repositories" and "Mounting Documentation Repositories", a mount point is used to attach to an external Git repository, either public or private, and make that content available for grafting into your document tree.

Managing Groups

To allow members of the organization to view content in organizational mount points, you'll create one or more groups, add members to those groups, and then grant permissions to the group to use the mount point.

Granting Permissions to Members

Each group you've created as an associated "access control list", where each entry in the access control list grants a permission to a mount point. You can have as many entries in the access control list as needed.

Viewing Documents from Other Organizations

Once you've been granted permissions to read a mount point in an organization, you can graft mount point documents into your document tree in the same way that you graft in content from personal mount points.

Searching for Documents in Other Organizations

By default, content from mount points in organizations for which you have been granted Search permission will appear in the search results list when you issue a search query.