Home

Принципы

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

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

Глоссарий

alias — псевдоним asset - ресурс (в значении "компонент, фильтр или директива") binding - связывание custom - собственный или пользовательский, в зависимости от контекста distributuion with slots - распространение слотами (не "через слоты") emit (event) - вызвать (событие) event listener - подписчик на событие hook - хук instance - экземпляр listen (to an event) - подписаться (на событие) mount - монтирование observe - наблюдение option - опция rendering - рендеринг (не рендер) rerendering - перерендеринг (не ререндеринг и не ререндер и не перерендер) route, router — путь, маршрут, маршрутизатор value accessible in foo.bar - значение в foo.bar (не "как" foo.bar и не "через" foo.bar) view — представление virtual DOM - виртуальный DOM watch - слежение (неконсистентно с "наблюдателем") watcher — наблюдатель

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