[Feature Request]:Improve Windows-specific guidance in installation guide

[wareeshaali2003]

Improve Windows-specific guidance in installation guide
Yes. The current installation guide is mostly platform-agnostic, which can cause confusion for Windows users. As a first-time contributor using Windows, it was unclear which terminal to use, which Python command (python vs. py) is recommended, and how to avoid common issues like CRLF line endings.

Describe the solution (or solutions) you'd like

Add a short Windows-specific section to the installation guide that:

• Recommends a preferred terminal (e.g., Git Bash)
• Clarifies which Python command to use on Windows
• Mentions common Windows pitfalls such as CRLF line endings
  Suggests suitable editors like VS Code with appropriate settings

Describe alternatives you've considered and rejected

I considered relying on external troubleshooting pages, but having these Windows-specific notes directly in the installation guide would be more helpful for first-time contributors.

This would make the setup process easier for new Windows contributors.

Additional context

This suggestion is based on my experience installing Oppia as a beginner on Windows.

[Abhinandankaushik]

Hi @mon4our

Problem
The current installation guide is largely platform-agnostic, which can be confusing for Windows users—especially first-time contributors. During my initial setup on Windows, it was unclear which terminal to use, whether python or py is the recommended command, and how to avoid common issues such as CRLF line endings.

Proposed Solution
I would like to improve the installation guide by adding a short, dedicated Windows-specific section that:

Recommends a preferred terminal (e.g., Git Bash)

Clarifies which Python command should be used on Windows (py vs python)

Mentions common Windows pitfalls such as CRLF line endings and how to avoid them

Suggests suitable editors (e.g., VS Code) along with recommended settings

Alternatives Considered
I considered relying on external troubleshooting resources, but including these notes directly in the installation guide would significantly improve the onboarding experience for new Windows contributors.

Request
If this improvement is within scope, I would be happy to work on it. Please let me know if I can be assigned to this issue or if there are any documentation guidelines I should follow.

This suggestion is based on my experience installing Oppia as a beginner on Windows.

[Meeth-webdev]

Hi @Abhinandankaushik this issue is still in triage needed . First this issue needs to be labelled , (for eg: priority low work low) . After this issue is labelled only then it is recommended that you provide a solution to this issue .

Whenever providing any solution to the issue it is expected that you show ur enhancement through a video so that the members have a clear idea regarding how ur fix looks like.

Until this issue is still in triage you can work towards good first issues : https://github.com/oppia/oppia/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22

Or you can work on other labelled issues as well .

Thank you so much and I hope you get my point 👍👍

[LoveChauhan-18]

Hi, I would like to work on this issue. Please assign it to me!