Skip to content

docs: add local development troubleshooting guide#81

Open
Roeenk27 wants to merge 1 commit into
thoth-tech:mainfrom
Roeenk27:docs/local-dev-troubleshooting
Open

docs: add local development troubleshooting guide#81
Roeenk27 wants to merge 1 commit into
thoth-tech:mainfrom
Roeenk27:docs/local-dev-troubleshooting

Conversation

@Roeenk27
Copy link
Copy Markdown
Contributor

Description

This PR adds a local development troubleshooting guide to the doubtfire-astro documentation site. The guide covers common setup issues contributors encounter when getting OnTrack running locally, based on firsthand experience from T1 2026.

Issues covered:

  • Ruby version conflicts and RVM setup
  • Database setup using db:schema:load instead of db:migrate
  • RabbitMQ environment variables not persisting between sessions
  • Port conflicts and how to resolve them
  • Frontmatter requirements for the docs site
  • npm install errors
  • Docker Compose common issues
  • WSL-specific notes

Type of change

  • Documentation (new)

How Has This Been Tested?

Steps and commands verified through personal local setup experience during T1 2026.

Checklist

  • I have performed a self-review of my own work
  • My changes follow the style guidelines of this project
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have requested a review from a peer on this Pull Request

@netlify
Copy link
Copy Markdown

netlify Bot commented May 12, 2026

Deploy Preview for ontrackdocumentation ready!

Name Link
🔨 Latest commit e41cd7e
🔍 Latest deploy log https://app.netlify.com/projects/ontrackdocumentation/deploys/6a02cf37b18b5d00086383ce
😎 Deploy Preview https://deploy-preview-81--ontrackdocumentation.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

@jmirchh75 jmirchh75 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 Roeen, definitely helpful for new contributors and can be expanded if needed.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants