Skip to content

docs: update Troubleshooting page with discussion-based fixes#514

Open
rohanmalhotracodes wants to merge 3 commits intooppia:developfrom
rohanmalhotracodes:docs/update-troubleshooting-discussions
Open

docs: update Troubleshooting page with discussion-based fixes#514
rohanmalhotracodes wants to merge 3 commits intooppia:developfrom
rohanmalhotracodes:docs/update-troubleshooting-discussions

Conversation

@rohanmalhotracodes
Copy link
Contributor

@rohanmalhotracodes rohanmalhotracodes commented Feb 25, 2026 •
edited
Loading

Summary of Changes

  • Added a note at the top of the troubleshooting page clarifying that it includes solutions from GitHub Discussions updated before February 25, 2026.
  • Added additional troubleshooting entries sourced from relevant GitHub Discussions.
  • Updated the Table of Contents to reflect the newly added sections.
  • Resolved Issue Update docs to reflect removal of config tab #434 by removing outdated references to the Config tab and restructuring the steps to match the current admin workflow.
  • Clarified and expanded multiple steps related to:
    • Populating translation opportunities
    • Populating question opportunities
    • Generating explorations
    • Creating classrooms
  • Ensured the instructions align with the current UI and role assignment process.
  • Cross-verified the updated steps using:
    • The How to access Oppia webpages wiki documentation
    • LEAP team / Contributor Dashboard documentation
    • Admin Roles and Activities workflow
    • Classroom Admin workflow
  • Updated outdated documentation links where necessary.
  • Fixed minor typos and terminology inconsistencies for consistency and professionalism:
    • Opia → Oppia
    • Github → GitHub

Although the typo fixes were not explicitly part of the original scope, they were minor consistency corrections and included here to avoid raising separate issues.

Issues Addressed

Fixes #207
Fixes #434

@rohanmalhotracodes
docs: update Troubleshooting page with discussion-based fixes
01f43df 
- Added note at top of page
- Added troubleshooting entries from GitHub Discussions
- Updated Table of Contents

Fixes oppia#207
@rohanmalhotracodes rohanmalhotracodes deleted the docs/update-troubleshooting-discussions branch February 25, 2026 16:19
@rohanmalhotracodes rohanmalhotracodes restored the docs/update-troubleshooting-discussions branch February 25, 2026 16:20
@rohanmalhotracodes
Revise loading data and classroom creation steps
b50d646 
Updated instructions for loading data and creating classrooms, including clarifications and reordering of steps.
@rohanmalhotracodes
Copy link
Contributor Author

rohanmalhotracodes commented Feb 25, 2026 •
edited
Loading

@HardikGoyal2003 for #434 (comment)
The "Config tab" reference also appears in the Oppia Wiki page How-to-access-Oppia-webpages.md, which is part of the oppia/oppia.wiki repository.
Since this is not in oppia-web-developer-docs, should this issue be moved to the main Oppia repo instead?

I have included the other changes in this PR itself.

PS: Can we maybe raise a new issue in the main repo of Oppia since I have included the fixes needed in docs here itself.

This was referenced Feb 25, 2026
Open
Open
@rohanmalhotracodes
Copy link
Contributor Author

rohanmalhotracodes commented Mar 1, 2026

@jayam04 PTAL, gentle reminder.

@rohanmalhotracodes
Copy link
Contributor Author

rohanmalhotracodes commented Mar 3, 2026

@jayam04 gentle ping.

jayam04
jayam04 requested changes Mar 5, 2026
View reviewed changes
Copy link
Member

@jayam04 jayam04 left a comment

Choose a reason for hiding this comment

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

@rohanmalhotracodes Thank you for the updates. I have reviewed your changes.

Troubleshooting.md Outdated
Comment on lines +349 to +353
2. Run: `python -m scripts.start --dev`
3. If the issue persists, try: `python -m scripts.start --clean`
4. If necessary, run `yarn install` and restart the server.

This is typically a frontend build or caching issue rather than a backend problem.
Copy link
Member

@jayam04 jayam04 Mar 5, 2026

Choose a reason for hiding this comment

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

@rohanmalhotracodes There is no option --dev

Troubleshooting.md Outdated
Comment on lines +363 to +368
1. Start the dev server.
2. Go to: `http://localhost:8181/admin`
3. Assign yourself the **admin role** from the roles tab.
4. Restart the server if necessary.

After assigning the admin role, the `/admin` page should load correctly.
Copy link
Member

@jayam04 jayam04 Mar 5, 2026

Choose a reason for hiding this comment

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

Specify, you must use email suggested on login for the first time to access /admin page.

Troubleshooting.md Outdated
Comment on lines +398 to +402
### oppia-angular-build container exits during install/run

If the Oppia installation (e.g., `make build`, Docker startup, or `python -m scripts.start`) fails because the `oppia-angular-build` container exits unexpectedly or the build does not complete:

**Possible fixes:**
Copy link
Member

@jayam04 jayam04 Mar 5, 2026

Choose a reason for hiding this comment

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

This was part of Docker setup, which we have already dropped. So, you can remove this.

@rohanmalhotracodes
Copy link
Contributor Author

rohanmalhotracodes commented Mar 6, 2026

@jayam04 sir, I have tried to resolve everything addressed above. If I have missed anything please do let me know. Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@jayam04 jayam04 jayam04 requested changes

Requested changes must be addressed to merge this pull request.

Assignees

@jayam04 jayam04

Labels

None yet

Projects

None yet

Milestone

No milestone

2 participants

@rohanmalhotracodes @jayam04