Skip to content

docs: record the awesome-entra submissions and what they required #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
juandresrodca wants to merge 2 commits into from
Closed

docs: record the awesome-entra submissions and what they required #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
eb5d6c6
docs: record the awesome-entra submissions and what they required
juandresrodca Sep 22, 2026
133ab70
docs: point the EntraHuntKit reference at the reopened PR
juandresrodca Sep 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# IntuneGraph

**Turn your Microsoft Intune tenant into an interactive relationship graph.** See what actually applies to a device and *why*, preview the blast radius before you touch a group, and find the orphaned junk, all from a local, read-only snapshot.
**Turn your Microsoft Intune tenant into an interactive relationship graph.** See what applies to a device or user and why, preview the blast radius before you touch a group, and find orphaned or broken assignments. Read-only Graph, offline-capable demo, self-contained HTML viewer. Zero write scopes.

[![PowerShell Gallery](https://img.shields.io/powershellgallery/v/IntuneGraphKit?label=PSGallery)](https://www.powershellgallery.com/packages/IntuneGraphKit)
[![PowerShell](https://img.shields.io/badge/PowerShell-5.1%20%7C%207%2B-5391FE)](#requirements)
Expand Down
54 changes: 54 additions & 0 deletions docs/discoverability.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,60 @@ together rather than listing every repository flat.

---

## Index submissions

Reach is not the metric; overlap is. A list read by the people who administer the thing
this tool models is worth more than a general-purpose one with a hundred times the stars.
The entry that matters is the one on the list the audience already reads.

This table is the record. **Check it before submitting anywhere**, so that a rejected
entry is not cheerfully resubmitted six months later by someone who has forgotten.

| Date | Index | Repo | Section | PR | State |
|---|---|---|---|---|---|
| 2026-09-22 | [merill/awesome-entra](https://github.com/merill/awesome-entra) | IntuneGraph | Tools -> CLI | [#27](https://github.com/merill/awesome-entra/pull/27) | Open |
| 2026-09-22 | [merill/awesome-entra](https://github.com/merill/awesome-entra) | [EntraHuntKit](https://github.com/juandresrodca/EntraHuntKit) | Tools -> Log Analytics, KQL, Logic Apps | [#28](https://github.com/merill/awesome-entra/pull/28) | Open |

### The rules that list enforces

Its `contributing.md` is short and it is checked. One link per pull request, which is why
these are two PRs and not one. Alphabetical ordering where the section already has it: the
CLI list does, so IntuneGraph sits between GraphRunner and JWTDetails; the KQL list does
not, so EntraHuntKit went beside the other `Entra*` entries. A stars badge, a description
ending in a full stop, no trailing whitespace, and a PR title of the form
`Add user/repo - Short repo description`.

Two things it does not spell out, but that a maintainer looks for anyway: whether the
project credits its alternatives rather than talking past them, which is what
[`comparison.md`](comparison.md) is for, and whether a contributor arriving from the list
has somewhere to land, which is what the issue forms and pull request template under
`.github/` are for. Neither existed a fortnight ago, and submitting before they did would
have been submitting a worse repository.

### One description, not three

A listing is another place the project describes itself, and the quickest way to look
careless is to describe it differently in each one. So the entry text is the **repository
description, verbatim** - the same text recorded under [*Description*](#description) above,
and the same text the README opens with. Three surfaces, one sentence.

The README lead was reworded in this commit to close a gap that had already opened between
it and the repository description; they now match word for word. Changing the pitch means
changing all three in the same commit, which is the rule already stated for the Gallery
manifest and now extends to any index this project is listed in.

### Deferring to upstream

While submitting, EntraHuntKit's `ioc/malicious-oauth-app-ids.md` was found to be
hand-maintaining a table of Microsoft first-party app IDs, and two of its six rows had
drifted from [merill/microsoft-info](https://github.com/merill/microsoft-info), the
maintained daily-regenerated source for exactly that data. It now cites the feed rather
than restating it ([EntraHuntKit#6](https://github.com/juandresrodca/EntraHuntKit/pull/6)).

Worth generalising: an index maintainer notices when a submission duplicates something
they already maintain. Citing it is both more accurate and a better first impression than
a copy that quietly rots.

## Reviewing this

Worth a look whenever the project gains a capability that someone would search for by
Expand Down
Loading