Skip to content

fix: add venv instructions in docs for beginners#1222

Merged
DawoudSheraz merged 3 commits intooverhangio:releasefrom
edly-io:fix/venv-instructions
May 14, 2025
Merged

fix: add venv instructions in docs for beginners#1222
DawoudSheraz merged 3 commits intooverhangio:releasefrom
edly-io:fix/venv-instructions

Conversation

@hinakhadim
Copy link
Copy Markdown
Contributor

Description

This PR updates the installation documentation (install.rst) to recommend using a Python virtual environment when installing Tutor. The update is based on recurring issues observed in the community, such as permission errors on fresh systems, and challenges in managing dependencies. These concerns were raised in Tutor Issue #1198 and discussed in the Open edX Forum, where users reported problems due to system-level Python installations.

Changes

Added a Virtual Environment (Recommended) section under the "Requirements"

@DawoudSheraz DawoudSheraz moved this from Pending Triage to In review in Tutor project management Apr 17, 2025
docs/install.rst Outdated
.. _install_binary:


Virtual Environment (Recommended)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's add this in Requirements section

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have moved this into the Requirements section

Copy link
Copy Markdown
Contributor

@DawoudSheraz DawoudSheraz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: the commit type should be docs, not fix.

@DawoudSheraz DawoudSheraz requested a review from regisb May 6, 2025 09:10
Copy link
Copy Markdown
Contributor

@regisb regisb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good to me!

@DawoudSheraz DawoudSheraz merged commit d00d72b into overhangio:release May 14, 2025
2 checks passed
@github-project-automation github-project-automation bot moved this from In review to Done in Tutor project management May 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

3 participants