Home

Принципы

Документация vue.js — не произведение Достоевского. Нет задачи сохранить стиль или точно передать оттенки смысла. Главное, чтобы читатель с родным русским языком и хорошим английским выбрал переведённую инструкцию, а не оригинальную.

Можно полностью менять логику мысли в рамках абзаца. Звучать должно так, как будто вы написали фреймворк и теперь объясняете как он работает своему русскоязычному коллеге. То есть англицизмам в лексике — строго да, англицизмама в синтаксисе — строго нет.

Глоссарий

option - опция

instance - инстанс

observe - наблюдение

watch - слежение

mount - монтирование

rendering - рендер (не рендеринг)

rerendering - перерендер (не ререндер)

hook - хук

virtual DOM - виртуальный DOM

asset - ресурс (в значении "компонент, фильтр или директива")

custom - собственный или пользовательский в зависимости от контекста

mixin - миксин

distributuion with slots - распространение слотами (не "через слоты")

value accessible in foo.bar - значение в foo.bar (не "как" foo.bar и не "через" foo.bar)

binding - связывание event listener - подписчик на событие listen (to an event) - подписаться (на событие) emit (event) - вызвать (событие)

не надо использовать конструкции "подписчика(-ов)". Напишите полностью "подписчика или подписчиков" или "одного или нескольких подписчиков", смотря что получится благозвучнее.