First off — thank you. Every contribution helps someone navigate the hardest career transition of their life.
- Go to the relevant repo's Issues tab
- Check if someone already reported it
- If not, open a new issue with a clear title and description
- Fork the repo
- Create a branch:
git checkout -b feature/your-feature-name - Make your changes
- Write clear commit messages
- Push and open a Pull Request
- Describe what you changed and why
- Fork the awesome-tech-immigration repo
- Add your content following the existing format
- Open a Pull Request with a brief description
We want every resource available in multiple languages. If you can help translate content from Persian to English (or any other language), open a PR or an issue offering help.
- Be respectful. We're a community of immigrants helping immigrants. Everyone is welcome regardless of nationality, career stage, or background.
- Be practical. Share what actually worked for you, not theoretical advice.
- Keep it real. If a tip helped you get hired, say where and when. Real data beats generic advice.
- Write in English for maximum reach. Add Persian (or other languages) as a bonus, not a replacement.
- For TypeScript/JavaScript projects: follow the existing ESLint config in the repo
- Write meaningful variable names
- Include tests for new features when the project has a test suite
- Open a GitHub Discussion in the relevant repo
- Or ask in our Telegram group — 17,000+ members ready to help
By the community. For the community.