AzureDevOps.InnerSource 🌟

Discoverability of InnerSource repositories on Azure DevOps suffers from a few limitations compared to Github. For example, it is very difficult to find a repository and to assess how mature it is. This project provides the following features:

• Aggregated view of all repositories within a project
• Badge to display the last commit date in a repository
• Badge to display the main programming language used in a repository
• Ability to "star" any Azure DevOps repository within an organization and display the number of stars with a badge

Demo

How this works

This works in 2 parts. First, an Azure DevOps Extension adds some features in the Azure DevOps organization. Second, the extension communicates with the deployed server. Right now, there is no hosted server offered, you must deploy it yourself. Keep reading for more instructions.

Getting started

1. Install the AzureDevOps InnerSource extension from the Visual Studio Marketplace.

2. Activate the feature flag on the desired project

   

3. Deploy the server, see server readme.

4. Under the "Repos" hub group, you should now see a hub called "All repositories". Click on it.

5. Click on the "Settings" button and set the server url (or navigate directly to https://dev.azure.com/<your organization>/_settings/gabrielbourgault.azuredevops-innersource.extension-settings-hub)

6. Edit readmes of all repositories you wish to aggregate with:

   <p id="description">TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project.</p>

   <pre id="packageInstallation"><code>npm install --save potato</code></pre>

7. Go back to the "All repositories" hub to view the aggregated repositories

Extension

View the extension readme.

Server

View the server readme.

Hosting

View the hosting readme.

Breaking changes

At this time, there is no guarantee on the stability of this template. Breaking changes may occur at any time.

Known issues

• The code coverage is very low right now
• There is a lot of boilerplate code for MVC that could be removed
• Security has been given some consideration, but would require further assessments
• Concurrent requests are not properly handled, the total star count could be wrong if 2 requests are made in parallel
• Running an Azure Container App with scale down to 0 replicas means that the first request is quite slow as it needs to boot an instance

Contibuting

• Star this GitHub repo ⭐ (ironic, isn't it 😉)
• Create pull requests, submit bugs, suggest new features or documentation updates 🔧. See contributing doc.

License

BSD 3-Clause © Gabriel Bourgault

See license.