Skip to content
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.

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

Replace recommendation for VSCode with recommendation for VSCodium in the beginners section #18421

Closed
wgrlogin opened this issue Jul 16, 2022 · 6 comments
Assignees
Labels
Content:Learn Learning area docs

Comments

@wgrlogin
Copy link

MDN URL

https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/Installing_basic_software

What specific section or headline is this issue about?

Installing a text editor

What information was incorrect, unhelpful, or incomplete?

"We recommend starting with [Visual Studio Code](https://code.visualstudio.com/), which is a free editor, that offers live previews and code hints."

VSCode is free as in "free beer". But it is not open source, it is proprietary software. There is an open source alternative called "VSCodium", but the link in the line above points to proprietary version of Microsoft.

VSCode or VSCodium do not offer live preview out of the box. You need to install a plugin, which is still under construction.

What did you expect to see?

It would by nice to see the following instead:
"We recommend starting with [VS Codium](https://vscodium.com/), which is a free and open source editor, that offers live previews and code hints."
VSCodium is build entirely on the open source repository "Code - OSS" without any "enrichments".

"VSCodium is identical to VS Code with the single biggest difference that unlike VS Code, VSCodium doesn't track your usage data." (itsfoss)

Do you have any supporting links, references, or citations?

Downlaod: https://vscodium.com/
See article: https://itsfoss.com/vscodium/
Install on Windows : winget install vscodium

Do you have anything more you want to share?

For me the way the recommendation is placed looks a little bit like an advertisement for a Microsoft product.
VSCode/VSCodium are very, very good editors. However, there are other editors that could be mentioned.
Espacially for beginners there is good old "bluefish". Ok, it comes with an old fashioned UX but has everything that beginners need to start with web development. Not as plugins but out of the box.
"kate" or - if you go for unfree software anyway - "sublime-text" are still out there, too.

MDN metadata

Page report details
@github-actions github-actions bot added needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. Content:Learn Learning area docs labels Jul 16, 2022
@awxiaoxian2020
Copy link
Contributor

I don't think it's like an ad for Microsoft product. Because it's open source and used by many people. Our Internet is built by everyone and we should respect who contribute for these.
Sure, we can add other editors. It's a good idea.

@sideshowbarker
Copy link
Collaborator

I think we should seriously consider deleting the entire “Installing basic software” page.

This issue reminds me of #7048, where we have a similar article that will forever require somebody to actively work to try to ensure it stays up to date. But I don’t think the cost of doing that’d be justified by the limited benefits MDN readers would get from somebody doing the work — because the bad combination of characteristics which this article and this one have is:

  • the article doesn’t give essential info that’s not already available in other places (unlike, e.g., all our reference content):
  • the article requires more maintenance to be kept up to date than other content (e.g., our reference content)

See my further comments at #7048 (comment).

All that said, if don’t have agreement about deleting the “Installing basic software” page, then perhaps let’s at least consider replacing the current content of the “Installing a text editor” section with text that instead just says something like:

There is a rich selection of text editors you can use for creating and editing HTML and CSS and JavaScript content. Wikipedia has details about many such editors; so to find an editor that fits your needs, take time to read through some relevant Wikipedia pages — for instance, try starting from the “Notable examples” section of the Wikipedia “Source-code editor” article, and following the links there to the pages where you can read all the details about each editor.

@sideshowbarker sideshowbarker removed the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Jul 19, 2022
@awxiaoxian2020
Copy link
Contributor

I think we should seriously consider deleting the entire “Installing basic software” page.

This issue reminds me of #7048, where we have a similar article that will forever require somebody to actively work to try to ensure it stays up to date. But I don’t think the cost of doing that’d be justified by the limited benefits MDN readers would get from somebody doing the work — because the bad combination of characteristics which this article and this one have is:

  • the article doesn’t give essential info that’s not already available in other places (unlike, e.g., all our reference content):
  • the article requires more maintenance to be kept up to date than other content (e.g., our reference content)

See my further comments at #7048 (comment).

All that said, if don’t have agreement about deleting the “Installing basic software” page, then perhaps let’s at least consider replacing the current content of the “Installing a text editor” section with text that instead just says something like:

There is a rich selection of text editors you can use for creating and editing HTML and CSS and JavaScript content. Wikipedia has details about many such editors; so to find an editor that fits your needs, take time to read through some relevant Wikipedia pages — for instance, try starting from the “Notable examples” section of the Wikipedia “Source-code editor” article, and following the links there to the pages where you can read all the details about each editor.

I agree that replacing the section with a brief text instead of a particular editor.
deleting whole the page may be unfriendly for beginners.

@wgrlogin
Copy link
Author

In my eyes deleting the whole page would be a pitty.
The WWW is full of pages titled "Web Development for Beginners" and compared to others the MDN page is one of the really, really good ones!
Don't drop it! That is definitely not what I wanted to achieve.

My only concern was that VSCode is just not open source and the article explicitly states it instead of pointing to the open source VSCodium.

Pointing to the list in Wikipedia is a good idea.

Thank you

@Josh-Cena
Copy link
Member

For what it's worth, despite being a huge advocate of open-source, I have to say the sentiment that "non-open-source is bad; proprietary is bad; telemetry is bad" is highly subjective. For a beginner tutorial I'll definitely go with recommending VSCode as default—it has richer support and is backed by a strong organization. Sure, VSCodium is almost a clean fork of VSCode, but there's no guarantee it won't go out of sync, or it won't be unable (sorry for the triple negation) to produce the necessary diagnostic data when bugs occur. It's just much easier to say "here's THE most popular text editor on the planet today, here's its docs, try it out".

@Rumyra
Copy link
Collaborator

Rumyra commented Jul 28, 2022

This is a page for beginners and pointing them to a popular ide to get them started is within the scope of content. Agree with @Josh-Cena here

For a beginner tutorial I'll definitely go with recommending VSCode as default—it has richer support and is backed by a strong organization.

As such I'm closing this issue, but thanks for raising it @wgrlogin - further to the other comments this raised I've open a discussion about the 'Getting started with the web' area mdn/mdn-community#161

@Rumyra Rumyra closed this as completed Jul 28, 2022
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 1, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Content:Learn Learning area docs
Projects
None yet
Development

No branches or pull requests

5 participants