Skip to content
This repository has been archived by the owner on Aug 10, 2022. It is now read-only.

An automated tool created using Azure Functions that double checks each Readme to ensure every repository is leveraging Web Trends

License

Notifications You must be signed in to change notification settings

brminnick/GitHubReadmeWebTrends

Repository files navigation

GitHub Readme + WebTrends

To best understand which topics are popular and which subjects are trending in our developer communities, we can leverage Web Trends.

This is an automated tool created using Azure Functions that double checks each Readme to ensure every repository is leveraging Web Trends.

Web Trends does not collect any Personally Identifiable Information and cannot be traced back to any individual user.

Architecture

FAQ

How do I opt-in to the tool? (Prerequisite: Only Microsoft employees are able to opt-in)

How do I opt-out from the tool?

The tool is using the wrong value for Area/Team - How do I fix it?

The tool is using the wrong GitHub Username - How do I fix it?

Can we extend this functionality beyond GitHub to other sites like Dev.to?

  • Probably! As long as other sites have an API, we can likely expand this automated tool to update those resources as well!
  • Feel free to open a feature request (ie open an Issue in this repo) and we'll chat about it!

How do I know if my GitHub Repo is still active?

  • I've created an iOS + Android app to help with this, GitTrends: https://GitTrends.com
    • GitTrends shows you the number of Views & Clones that each of your GitHub repos are receiving, and it will send you a push notification when one of your GitHub Repos is trending!
    • Download it on iOS
    • Download it on Android

I received 30+ PRs this month. Will I receive 30+ PRs again next month?

  • Nope! As long as you merge this month’s PRs, you will receive substantially less PRs next month

Why didn’t I get an email notifying me of the PR?

  • GitHub only sends you a notification Email if you are “Watching” the repo
  • Double check your repos to ensure that you are “Watching” it

Why do I still have PRs rolling in? I thought the tool was supposed to run once per month?

  • This is mostly because of the GitHub API Rate Limit
    • tl;dr The GitHub API only allows me to make 5,000 API Requests per Hour
    • Once the tool reaches the limit, I queue up the remaining work on a backlog that uses a Timer Trigger Function to run once per hour
  • I published a NuGet package to help fellow .NET Devs work with and understand the GitHub API Rate Limits: https://github.com/brminnick/GitHubApiStatus
    • This NuGet package is being leveraged by this automated GitHub Readme + WebTrends tool 😄