Информация о разделе
denisputnov opened this issue · comments
Проблема
Информация о разделе кажется бесполезной:
Почему:
-
На мой вкус, если человек заходит читать доку, например, о JavaScript, то он уже знает что это такое. Мне кажется немного неконсистентным то, что рядом со статьёй о событийной модели браузера у нас идёт описание того что такое JavaScript. Это странно. То же самое, что учёному математику рассказывать что такое цифры. Не понимаю зачем.
-
Слишком много места занимает. Я скролю раздел и у меня часть экрана просто пустая, потому что выше у меня написано что такое JavaScript.
Вот как это выглядит при скролле
Какие решения я вижу:
-
Пересмотреть этот блок и сделать его горизонтальным в начале страницы, а оглавление расширить до всей ширины страницы
-
Вынести обзорный контент в отдельную статью, которую можно будет положить в блок "Основы"
-
Идеальное решение на мой вкус: сделать быструю навигацию по оглавлению, как это сделано, например, у antd справа
О какой быстрой навигации идёт речь
Привет!
Текстовая подводка к содержанию раздела кажется излишней, и я согласна, что свободное место можно использовать с большей пользой. Предложение добавить туда навигацию поступает не первый раз (#709), и я думаю, что это хорошая идея. Однажды мы или контрибьюторы обязательно это реализуем.
только недавно подумал что было бы прикольно добавить список тем внутри каждого раздела, по аналогии как внутри каждой статьи есть список разделов статьи)
file:///home/user/image.jpg