By providing team features such as project collaborators or notifications, SymfonyInsight is well suited to development teams.
Getting started with SymfonyInsight as a team consists of three simple steps:
When working in a team, you are likely to need several collaborative features provided by SymfonyInsight such as project collaborators. We recommend you to purchase one of the Business plans as they are the most likely to match your needs. Have a look at the pricing page to buy one.
Additionally, as a team you will likely need to be able to transfer the plan you buy to someone else easily. This is why we usually recommend teams to create a SymfonyConnect account dedicated to their company or team. This will allow you to transfer the credentials easily as the account won't be a personnal one.
Once you purchased a plan and are logged in, you will see your Dashboard, a page aggregating all the notifications related to your projects over time. At first, your Dashboard is empty: click on "Add a project" to start filling it.
SymfonyInsight needs access to your code to analyze it. Configuring this access depends on where your code is hosted (GitHub, Bitbucket, GitLab, ...).
There are documentation sections specifically written to help you with each platform:
Once SymfonyInsight has access to your code, it will automatically start a first analysis of your code.
Why should I specify a project type?
Assigning the correct project type is important as some metrics only run on a subset of project types. For instance, it doesn't make sense to check for a favicon in a simple PHP library. Likewise, all rules specific to Symfony applications should not run against WordPress plugins. Thus, choosing thoroughly the category fitting the best with your project will remove false positives and improve the analysis accuracy.
Depending of the size of your project, the analysis will take from seconds to minutes to complete. Once finished, you'll see the scoring of your project. The project scoring is divided into four main sections:
1 Quality Grade, which visually summarizes the quality level of your project. SymfonyInsight uses a quality scale based on medals and numeric score. The five medals, from highest to lowest grade, are: platinum, gold, silver and bronze. They are represented by the following icons:
On top of that, you'll see a number that grades your quality between
100. This numeric score gives you a more precise estimate to track the
evolution of your project quality in time.
In this example, the project didn't get any medal and the score was just
because its quality is very low.
2 Error severity list, summarizes all the errors grouped by severity. This helps you and your team focus first on fixing the most critical errors.
3 Time to improve, displays the amount of work needed to improve the project quality to the highest level. In this example, approximately 11 months of work are needed to achieve that quality level. Move your mouse over this section to reveal the amount of work needed to increase the quality by just one level:
4 Critical security alerts, shows the list of errors that could cause serious security problems.
In addition to the previous project scoring, SymfonyInsight analyzes generate a fully detailed report showing every project error and instructions about how to fix them.
The full analysis report is divided into three main sections:
Project development is usually a team work. It is important to share the analysis results with every developer in the team and this is the purpose of collaborators. Your collaborators can read the analyses of your projects, run new analyses, and comment on the violations. They cannot change your projects configuration or add a new project.
The collaborators feature is only available on Business plans (Pro, Enterprise, and Premium). You can manage your current plan on your account page.
To grant access to collaborators, click on a project and click on "Edit project". In this page, you will be able to add collaborators by using their SymfonyConnect username.