Pull Request

This is my fourth PR. I was translating the Autoplay page:

I decided to translate MDN’s Autoplay guide because it’s one of the most-visited, high-impact resources on handling complex, browser-specific autoplay policies, and I noticed it wasn’t yet available in my language—by working through its nuances around user gestures, permission models, and fallback strategies, I not only sharpened my own understanding of how Chrome, Safari, and Firefox treat media autoplay but also made this crucial, up-to-date guidance accessible to developers who don’t read English.

This page was quite challenging for me to translate, as there were many terms that I had not come across before. For example, the part below is very technical, so I had to use a dictionary created according to the standards for translating technical terms.

The file is 340 long covering topics about how ow browsers block audible media from playing automatically—allowing it only when muted, after user interaction, or via an explicit Permissions Policy—and shows how to detect and handle autoplay support using Navigator.getAutoplayPolicy() and the promise returned by .play(). It also covers autoplay behavior in the Web Audio API and details server-sent Permissions-Policy headers and browser flags for testing and debugging autoplay.

The procedure is all the same: find a source file int he english repository ->copy it to the translated->content repository->change the front matter properties->translate->add changes->comit->push->pull request. When I did my comit my changes, the automatic checks were done and I was assigned a reviewer.

Before pushing in order to check if the layout of the page is correct and there have been no mistakes, MDN community uses a simple shell command (echo … >> .env) to create a dotenv file that defines the CONTENT_TRANSLATED_ROOT environment variable (pointing the preview server at your local copy of the translated-content files), and then run yarn start (invoking the project’s Node-based dev server) to load those settings and serve the translated MDN site at http://localhost:5042 for live testing.


Comments

Leave a Reply

Your email address will not be published. Required fields are marked *