Running Evaluations

Overview

Evalo provides multiple convenient ways to start repository evaluations. Whether you're working within your dashboard or sharing assessments publicly, you can quickly initiate evaluations from several different locations.

Method 1: From Evaluations Screen

The evaluations screen provides a centralized location to manage and start new evaluations:

1. 1
   Navigate to Evaluations: Click on "Evaluations" in the main navigation sidebar.
2. 2
   Click "New Evaluation": Look for the "New Evaluation" button, typically located at the top right of the evaluations list.
3. 3
   Select Assessment: Choose which assessment you want to use for the evaluation from the dropdown menu.
4. 4
   Enter Repository URL: Paste the GitHub repository URL you want to evaluate.
5. 5
   Start Evaluation: Click "Start Evaluation" to begin the automated analysis process.

Method 2: From Assessment List

You can quickly run evaluations directly from the assessments screen using the run icon:

1. 1
   Go to Assessments: Navigate to the "Assessments" section in your dashboard.
2. 2
   Find Your Assessment: Locate the assessment you want to use in the list.
3. 3
   Click the Run Icon: Look for the play/run icon (▶️) in the actions column next to your assessment.
4. 4
   Enter Repository Details: A modal will open where you can paste the GitHub repository URL.
5. 5
   Launch Evaluation: Click "Start Evaluation" to begin the analysis.

Method 3: From Public Assessment Page

Public assessment pages allow external users to submit repositories for evaluation without needing an account:

1. 1
   Access Public Link: Visit the public assessment page using the shared link (e.g., /public/assessment/123).
2. 2
   Review Assessment Details: Read through the assessment description, requirements, and expectations.
3. 3
   Enter Repository URL: In the submission form, paste your GitHub repository URL.
4. 4
   Add Email (Optional): Optionally provide your email address to receive evaluation results.
5. 5
   Submit for Evaluation: Click "Start Evaluation" to submit your repository for analysis.

What Happens During Evaluation

Once you start an evaluation, here's what happens behind the scenes:

• Repository Analysis: Evalo clones and analyzes the repository structure, files, and content.
• Requirement Checking: Each requirement in the assessment is evaluated against the repository.
• AI Analysis: AI processes the code quality, structure, and generates recommendations.
• Score Calculation: The final score is calculated based on the weighted scoring system.
• Results Generation: Comprehensive evaluation results are compiled with scores, insights, and recommendations.

Best Practices

• Use Public Repositories: Ensure the repository is publicly accessible on GitHub for evaluation.
• Verify Assessment Setup: Make sure your assessment has requirements configured before running evaluations.
• Check Repository Quality: Ensure the repository has proper documentation and a clear structure for best results.
• Monitor Usage Limits: Keep track of your plan's evaluation limits to avoid interruptions.

Troubleshooting Common Issues

Next Steps

Now that you know how to run evaluations, here are some recommended next steps:

• Understand the scoring system to interpret evaluation results
• Create custom requirements for specialized assessments
• Learn about assessment templates for consistent evaluations
• Review the quick start guide for the complete workflow

---