search

expressjs / expressjs.com

https://expressjs.com
Other
5.25k stars 1.47k forks source link

Translate into Persian #1580

Open Mehraddev opened 2 months ago

Mehraddev commented 2 months ago

Hello Express.js team,

I'm interested in contributing to the project by translating the documentation into Persian. I believe this could help expand the framework's accessibility to Persian-speaking developers.

Before I begin i wanted to ask if such a contribution would be helpful to the project and if there are any specific guidelines I should follow. If there's already an ongoing effort for this, I'd be happy to collaborate.

Looking forward to your feedback!

bjohansebas commented 2 months ago

Hi @Mehraddev here are some guides on how to start - https://github.com/expressjs/expressjs.com/blob/gh-pages/CONTRIBUTING.md#contributing-translations

If you have any questions, feel free to ask. Someone from the team will help you (as soon as we can).

Mehraddev commented 2 months ago

is there any way to preview my work? i don't seem to find .html files to view the changes.

IamLizu commented 2 months ago

Hi @Mehraddev 👋

This website is built with Jekyll, which is built with Ruby. A little Google search on "how to install Jekyll" will help you.

Please read the README.md available at the root of this project, it includes instructions to run the site locally.

crandmck commented 2 months ago

@Mehraddev Also, we recently implemented Netlify deploy previews. So when you open a PR, a preview site will be deployed that implements the change, e.g. https://deploy-preview-1568--expressjscom-preview.netlify.app/ for PR #1568. You may want to also run/test changes locally, but if not you can at least see them with the deploy preview.

IamLizu commented 2 months ago

Hey @Mehraddev I am assigning this to you 🎉

If you need any real-time help, we are available in the OpenJS Slack.

chrisdel101 commented 2 months ago

TL;DR - please use a draft PR for development.

Just a note: If you do end up not running it locally, and rather using the preview feature, the best way for us is if you can please make it a draft pull request during development. Then when you switch it to a full non-draft, we know it's ready for review.