ymaps router или multiRouter

В документации почти все примеры по multiRouter.MultiRoute.
Для того, чтобы добавлять/удалять точки простого маршрута router.Route пришлось изучать дебагер.

Там нашлось route.model.getReferencePoints() и так далее. В общем, разобраться можно, но почему этого нет в документации?

Закралась мысль, что так задумано и нужно всегда пользоваться multiRoute. Или я чего-то не понял?

В общем, если нужен один маршрут, можно в multiRoute передать

params: {
    results: 1
}  

И как бы вопрос решён на этом...

Понятно, что route остаётся нужным для внутренней работы multiRoute, но наличие двух классов (route и multiRoute) немного путает вновь приобщившихся к API.