Suggestion to Improve Oppia Documentation (Setup Environment - Point 8)

[VanshikaSabharwal]

In the Oppia Installation Docs, point number 8 under "Setup a virtual environment" mentions:
“...create a .direnvrc file in your home directory...”

This usage of the word “home” can be confusing, especially for beginners. It may lead to a misunderstanding between:

• The home directory of the system (i.e. /home/username/)
• The parent folder where Oppia is cloned

Proposed Change

To eliminate this confusion, I suggest updating the wording from:

"...in your home directory..."

to:

"...in the root folder of your computer/laptop (i.e., your home directory, like /home/username/)..."

or more clearly:

"...in your user’s home directory (e.g., /home/your-username/, also called the root folder of your user account)..."

This change ensures clarity for all users, especially those unfamiliar with Linux directory structures.

Here’s a visual illustration for context:

[Helper2020]

@VanshikaSabharwal Hello I don't see the text "create a .direnvrc file in your home directory" on the page you linked

[VanshikaSabharwal]

@VanshikaSabharwal Hello, I don't see the text "create a .direnvrc file in your home directory" on the page you linked

Hello @Helper2020 apologies, the text is Add new file called .direnvrc into your home (~) folder with this content: at point number 7. Here is a picture of it.

[Helper2020]

@VanshikaSabharwal Hello, would you be willing to make the edit?

[VanshikaSabharwal]

@Helper2020 Yes, I can make the edits.

[Helper2020]

@VanshikaSabharwal Great. I think the sentence "...in your user’s home directory (e.g., /home/your-username/, also called the root folder of your user account)..." is correct. Can you also incorporate the tilde () shorthand—e.g., user’s home () directory—since it's commonly used to refer to the home directory. Additionally, you can mention that the user can run the pwd command to verify they're in the correct directory

[VanshikaSabharwal]

@VanshikaSabharwal Great. I think the sentence "...in your user’s home directory (e.g., /home/your-username/, also called the root folder of your user account)..." is correct. Can you also incorporate the tilde () shorthand—e.g., user’s home () directory—since it's commonly used to refer to the home directory. Additionally, you can mention that the user can run the pwd command to verify they're in the correct directory

yes i'll do that