General feedback about new-user experience with the docs for Query Expressions

[jdodds]

For context, I am:

• relatively new to F#
• have 0 prior .net experience
• not using visual studio (rider/emacs)
• not typically a windows dev
• typically targeting .net core
• the type of learner who follows along with sample code in language references

so this might be more of a me issue than not, but I was absolutely unable to get my environment set up to run the examples here, running into things that seemed to point at dotnet/fsharp#3303, fsprojects/FSharp.Data.TypeProviders#21, some sort of infinite wailing GAC pain, or alternately at issues with TLS versions that appear like they should be resolved, but without finding workarounds that ... worked .

The example(s) in the docs themselves seem pretty fine to me for what they're showing, but depending on how heavy these docs want to lean towards being a reference to people coming very fresh to the .NET ecosystem through F# it might be worth doing a pass on the presentation / expression of prerequisites here.

Assuming that happens, I'm happy to be a guinea pig for changes. If I had reached a point where I was able to play around here I'd have submitted a PR instead of this issue, but alas.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: c3514796-1d23-6213-51c8-a90e399a5afd
• Version Independent ID: 518ea6eb-b99d-deac-eca3-4a2be6b4baa9
• Content: Query Expressions - F#
• Content Source: docs/fsharp/language-reference/query-expressions.md
• Product: dotnet-fsharp
• GitHub Login: @cartermp
• Microsoft Alias: phcart

[dotnet-bot]

This issue has been closed as part of the issue backlog grooming process outlined in #22351.

That automated process may have closed some issues that should be addressed. If you think this is one of them, reopen it with a comment explaining why. Tag the @dotnet/docs team for visibility.