Тема для одноимённого опроса по предпочитаемому формату документации для того, чтобы каждый мог не только проголосовать, но и прокомментировать почему он предпочитает то или другое.

https://rsdn.org/poll/9967

Автор: velkin
Дата: 24.02 18:52
Вопрос: Предположим существует документация имеющая оглавление. Но одностраничная документация содержит якоря (#) на эту же большую страницу. А многостраничная документация каждый раз перекидывает на новые небольшие страницы. Чтобы вы предпочли, работать с одностраничной документаций или с многостраничной?

Одностраничная документация

Плюсы.

1. Страницу нужно загрузить лишь один раз.
2. Можно переходить по всей документации с помощью полосы прокрутки.
3. Поиск по странице работает на всю документацию.

Минусы.

1. Загрузка и обработка документации происходит дольше.
2. Нет изолированности одного раздела документации от другого.

Многостраничная документация

Плюсы.

1. Загрузка и обработка документации происходит быстрее.
2. Есть изолированность одного раздела документации от другого.

Минусы.

1. Страницы нужно загружать каждый раз.
2. Нельзя переходить по всей документации с помощью полосы прокрутки.
3. Поиск по странице работает лишь на одну страницу документации.

Обсуждение

Возможно у кого-то есть ещё свои аргументы в пользу того или иного варианта. Вопрос в том, что вы предпочитаете и почему?

Тема для одноимённого опроса по предпочитаемому формату документации для того, чтобы каждый мог не только проголосовать, но и прокомментировать почему он предпочитает то или другое.

https://rsdn.org/poll/9967

Автор: velkin
Дата: 24.02 18:52
Вопрос: Предположим существует документация имеющая оглавление. Но одностраничная документация содержит якоря (#) на эту же большую страницу. А многостраничная документация каждый раз перекидывает на новые небольшие страницы. Чтобы вы предпочли, работать с одностраничной документаций или с многостраничной?

Одностраничная документация

Плюсы.

1. Страницу нужно загрузить лишь один раз.
2. Можно переходить по всей документации с помощью полосы прокрутки.
3. Поиск по странице работает на всю документацию.

Минусы.

1. Загрузка и обработка документации происходит дольше.
2. Нет изолированности одного раздела документации от другого.

Многостраничная документация

Плюсы.

1. Загрузка и обработка документации происходит быстрее.
2. Есть изолированность одного раздела документации от другого.

Минусы.

1. Страницы нужно загружать каждый раз.
2. Нельзя переходить по всей документации с помощью полосы прокрутки.
3. Поиск по странице работает лишь на одну страницу документации.

Обсуждение

Возможно у кого-то есть ещё свои аргументы в пользу того или иного варианта. Вопрос в том, что вы предпочитаете и почему?