this post was submitted on 03 May 2025
265 points (98.5% liked)

Programming

19954 readers
393 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]



founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
[–] ChairmanMeow 4 points 1 day ago (3 children)

I mean, this user does quite eloquently raise a good point: https://github.com/dotnet/docs/issues/45996#issuecomment-2848267714

It's a single link all the way at the bottom of the page, so not really obtrusive. And given that there are people using Copilot this way, it's probably better to give them something to use docs-wise rather than leaving them to Copilot's mercy. The article linked to is also pretty much just instructions on how to do it, no real gushing about how amazing Copilot supposedly is.

[–] Mikina 2 points 53 minutes ago

I'd say a much better point is raised by this comment.

Dotnet Foundation's whole point is to be independent from Microsoft. Why is it then pushing it's AI slop? Even if we take the point of "there are people using it", then why doesn't it talk about JetBrains and their AI, or Claude?

[–] [email protected] 8 points 19 hours ago* (last edited 19 hours ago) (1 children)

That GitHub comment makes my brain hurt and gives me Microsoft community forum advisor (run ChEcKDiSK tO mAYbe fIX tHe ProBLem) and "leave the multi-billion dollar company alone" vibes.

Also it's not a single line - when looking at the source file - and a complete section instead.

GitHub Copilot, as used in the documentation here, is free and integrated into the IDE.

  1. It's inside the dotnet Docs. dotnet has nothing to do with an IDE. You can code/run dotnet code in any editor or terminal if you like.
  2. This person assumes that Visual Studio is the only IDE for dotnet. Looks like they never heard of Rider or VS Code or anything else.

I do not think that you can call it an ad if it is for a free tool.

WTF is he defining as an ad? "Advertising is the practice and techniques employed to bring attention to a product or service". The whole section is bascially "Hey you can use Copilot to do this" - that's an ad right there.

Even if you interpret this as encouraging users to pay

Makes no sense. Does this person think ad = you have to pay for it???

it is hardly the first time that dotnet documentation guides users towards paid Microsoft products: are we going to start complaining about all pages with references to Azure next?

  1. A deployment target is not the same as "AI"
  2. If a page/section is not named like "How to deploy example app to Azure" then it shouldn't contain any reference to Azure. And yes you should complain about such stuff if it exists.

The only part of this I actually object to is that I don't think that what essentially amounts to 'prompt an LLM' belongs in documentation, although at the very least the page does disclose that the output may be erroneous.

That's basically what the whole issue is about. WTF are you even talking about then? Just shut up and give an upvote.

Overall a totally useless comment.

[–] ChairmanMeow -1 points 17 hours ago

Also it's not a single line - when looking at the source file - and a complete section instead.

True, I misjudged the original screenshot at the top of the thread. Still, it is all the way at the bottom of the page.

  1. It's inside the dotnet Docs. dotnet has nothing to do with an IDE. You can code/run dotnet code in any editor or terminal if you like.
  2. This person assumes that Visual Studio is the only IDE for dotnet. Looks like they never heard of Rider or VS Code or anything else.

This seems a bit harsh. The dotnet docs have tons of examples where it's shown how to do something in VS Studio or VSCode. "How to use dotnet feature X in product Y" doesn't seem like an unreasonable thing to include in your docs, especially with Microsoft having developed both.

WTF is he defining as an ad? "Advertising is the practice and techniques employed to bring attention to a product or service". The whole section is bascially "Hey you can use Copilot to do this" - that's an ad right there.

Again I think you're being too harsh here. Not every mention of a product is necessarily an ad. The dotnet docs aren't an ad for dotnet for example. Given that this section is at the bottom of the page, doesn't demand any attention from the user and doesn't really seem like a direction for the user to start using Copilot, I find it hard to really consider it a proper advertisement. It's not saying "Hey you can use Copilot to do this", it's saying "If you want to use this with Copilot, here's how to do so". It makes no effort in convincing the reader that they should use Copilot, it's just instructions for those who already do use it.

There's also plenty of other places where the dotnet docs refer to non-dotnet products, e.g. this page on deep learning: https://github.com/dotnet/docs/blob/main/docs/machine-learning/deep-learning-overview.md

It mentions other products like Tensorflow and ONNX there. Are these mentions also ads?

  1. A deployment target is not the same as "AI"
  2. If a page/section is not named like "How to deploy example app to Azure" then it shouldn't contain any reference to Azure. And yes you should complain about such stuff if it exists.

Plenty of the how-to guides end with "and here's how to deploy your stuff to Azure!". The dotnet docs even have an entire section on Azure, a service that has very little if nothing to do with how dotnet works. But it's still mentioned and documented in the dotnet docs, because it can be useful information for dotnet developers.

That's basically what the whole issue is about. WTF are you even talking about then? Just shut up and give an upvote.

They're referring to how they don't find it useful info, but other people who do use Copilot more intensively might find it useful. It's also a completely different point: the creator of the issue objects to the docs section because they consider it an ad for Copilot. The comment author disagrees, but says they'd rather see it removed because it's just not that useful information, though acknowledging that they might not be the target audience. It's a different argument that does contribute to the discussion imo.

[–] [email protected] -3 points 23 hours ago (1 children)

I also feel this is reasonable too, but the votes don’t agree.

[–] [email protected] 3 points 20 hours ago* (last edited 18 hours ago)

I disagree so much with the "But it's free argument". Consider the millions YouTube videos with ads to free to play games. Would you consider them to be ad-free videos? And that's ignoring that Copilot isn't even free (either pay with data or with a subscription model)