Troubleshooting: Divergence between Linguist and Github Code Search (go-enry)

[DecimalTurn]

I think there should be at least a mention in the Troubleshooting page that go-enry doesn't support linguist-language overrides in the .gitattributes.

Overriding languages and types [through] .gitattributes is not yet supported. See src-d/enry#18.

I know that I was confused about this multiple times until I discovered that in the list of divergences.

It's especially weird when you click on a language featured in the language stats bar and code search tells you there is no files with that language in the project 😕

For example, if you go to the Fortran stdlib repo, the language breakdown tells you it's mostly Fortran, but when you click on it, code search tells you that no Fortran files are found.

And all that is because all the Fortran code uses the .fypp extension override in .gitattributes :
*.fypp linguist-language=fortran

Perhaps, this is just a case where the extension should be properly added to Linguist, but there is a lot of cases where the override in the .gitattributes file is the only option and this can lead to some confusion.

@Alhadis suggested to make this a seperate section:

This would be more suited to a separate troubleshooting entry explaining why some files aren't being listed when filtering by language (ideally after the “My repository is detected as the wrong language” entry). [...]

Any thoughts?

---

NB: The dicussion on this started here: #6365 (comment) , but it's probably better to have a discussion like this in the discussion section.

[DecimalTurn]

Addressed here : #6468