Welcome to Pluralsight Flow. Before you can explore the features and reports available to you, you must complete your initial configurations. These configurations ensure your data is imported in a way that makes sense for your organization. Skipping steps will result in increased processing time to accurately ingest and configure your data.
Note: If you plan to use Flow with an internal server or behind a firewall, allowlist Flow's static IP addresses so Flow can access your Git repositories.
In this article
Before getting started
Now that you have access to Flow, make sure to add anyone else who'll be helping set Flow up.
Admins are responsible for connecting your organization’s integrations and making sure Flow has access to your data. Admins need to understand the workflow of teams and what integrations and repos those teams work on.
Flow automatically chooses an admin when a Flow organization is created. If you're not the right person to manage your organization's configurations and data, select at least one other person to be a Flow admin.
If this person doesn't have access to Flow, send a Flow invite and give them admin permissions.
Permissions
You must have the correct permissions to view Settings overview.
To view Settings overview, you must have the following permissions:
- View and manage integrations or View, manage, and delete integrations
- Manage group programming
- Manage users & teams
Learn more about administrative permissions.
Settings overview
Settings overview can make setting your configurations easier. Settings overview walks you through the most important Flow configurations, ensuring you don’t miss anything.
Follow Flow's guided steps for setup. To change configurations later, either return to Settings overview or access these same configurations through the side navigation.
To access Settings overview, navigate to Flow and click Settings in the top navigation. From there, follow the guide to change configurations or use the side navigation to access other settings.
When starting with Flow, set your configurations according to the steps provided in Settings overview. Make sure these configurations match your company practices.
Default domain
In step 1, set your default domain.
When developers make commits, the username of those commits may vary. Your default domain designates the email domain of the user that's chosen as the main user. If more than one user account is found for a person, Flow uses the default domain to determine the correct account.
Initially, the default domain is based on the first administrator's email address. Check that this default is correct so you can easily merge users after your data is ingested.
Important: If your default domain isn't set correctly when merging users, your Flow data will be inaccurate and you'll need to update the default domain and manually merge and unmerge users in the future. This can be a lengthy process. Ensuring your default domain matches the domain you want to use for apex users saves you time in the future. Setting this up before you import data is the fastest path to success.
Group programming
In step 2, set your Group programming preferences. Group programming is enabled by default.
Visualize contributions made by multiple users with group programming and customize how group work is credited to multiple people. This helps Flow know how to handle co-authored commits.
Disable group programming or further customize it for your needs.
Auto-merge users
In step 3, set your auto-merge preferences.
Auto-merge is enabled by default. If there are names or emails you don’t want to include in auto-merge, add them in the Exclusions section’s text box, separated by commas.
Auto-merge automatically merges aliases based on the user’s sign in email address or user email addresses. Aliases with the same email addresses merge regardless of their usernames.
Pull in data
Next, add integrations and import repos. Follow the steps in Chapter 2 of the getting started guide.
What's next?
Now that you've set up your initial configurations, import your data and learn how to manage it.