RoadGraph_Docs

Обсуждение материалов сайта: вопросы, замечания, предложения
Ответить
stopa85

RoadGraph_Docs

Сообщение stopa85 »

Предлагаю рецензировать документацию по плагину RoadGraph на предмет полноты и понятности:
Старая версия
Новая версия

Ну и обновить на сайте, естественно.
Аватара пользователя
Максим Дубинин
MindingMyOwnBusiness
Сообщения: 9129
Зарегистрирован: 06 окт 2003, 20:20
Репутация: 748
Ваше звание: NextGIS
Откуда: Москва
Контактная информация:

Re: RoadGraph_Docs

Сообщение Максим Дубинин »

Эта дока гораздо лучше.

Пара технических моментов.
1. Картинки лучше прямо в текст, в полном разрешении. Там где они не влезают (нужно помнить про 750 по ширине), сделать ссылками, но не с мелких превью как сейчас, а с картинок побольше (как первая иллюстрация).
2. На первой картинке нужно подписать более полно, что это RoadGraph в QGIS и объяснить что именно на ней загружено и делается, новичку непонятно.
3. "При использовании более-менее актуальной версии QGIS" - так какой?
4. Видимо даже до пункта Установка я бы в небольшой преамбуле еще раз по шагам написал бы, что нужно для работы. Установить, загрузить данные, тыкать в карту...
пристегивайтесь, турбулентность прямо по курсу
Voltron
Гуру
Сообщения: 2627
Зарегистрирован: 29 мар 2007, 14:12
Репутация: 34
Откуда: Ukraine

Re: RoadGraph_Docs

Сообщение Voltron »

Исправил скриншоты, уточнил версию QGIS и описание первой картинки. Про преамбулу не совсем понял, как работать с модулем описано ниже, зачем еще раз это выносить?
stopa85

Re: RoadGraph_Docs

Сообщение stopa85 »

Voltron,
Про преамбулу не совсем понял, как работать с модулем описано ниже, зачем еще раз это выносить?
Ниже описано какая кнопка за что отвечает.
Выбор начальной и конечной точек маршрута выполняется при помощи соответствующих кнопок возле полей ввода. Координаты выбранных точек будут отображены в полях ввода.
Нажатие на кнопку «Рассчитать» запустит поиск кратчайшего маршрута с использованием критерия оптимизации, заданного выпадающим списком «Критерий». Кнопка «Экспорт» служит для экспорта построенного маршрута в новый векторный слой, а при помощи кнопки «Очистить» выполняется очистка полей с координатами начальной и конечной точек, а также из области карты удаляются сами точки и построенный маршрут...
Трудно это считать руководством к действию. Максим же предлагает добавить пошаговый алгоритм работы. На неделе подготовлю руководство + выложу тестовый (вылизанный) набор данных.
stopa85

Re: RoadGraph_Docs

Сообщение stopa85 »

И еще по поводу версий. Думаю, вообще не стоит, давать ссылки на ревизии. RoadGraph - часть QGIS начиная с версии 1.6 ... В версии 1.8 ожидается network-analysis ... Что скажите?
Voltron
Гуру
Сообщения: 2627
Зарегистрирован: 29 мар 2007, 14:12
Репутация: 34
Откуда: Ukraine

Re: RoadGraph_Docs

Сообщение Voltron »

[quote="stopa85"]Ниже описано какая кнопка за что отвечает.[quote]
Вот именно. Расписывание того как загрузить слой, как нажать на кнопку, как кликуть по карте... это уже слишком, имхо.
Аватара пользователя
Максим Дубинин
MindingMyOwnBusiness
Сообщения: 9129
Зарегистрирован: 06 окт 2003, 20:20
Репутация: 748
Ваше звание: NextGIS
Откуда: Москва
Контактная информация:

Re: RoadGraph_Docs

Сообщение Максим Дубинин »

поясню, преамбула не должна давать пошагового руководства, а просто сходу давать представление "как это работает", я с удовольствием это попробую приписать как мне видится, а вы поправьте или снесите, если не понравится.

Это не отменяет возможности сделать либо в статье либо отдельно четкого примера работы с расширением, если считаете это нужным. С тестовыми данными.
пристегивайтесь, турбулентность прямо по курсу
stopa85

Re: RoadGraph_Docs

Сообщение stopa85 »

Максим Дубинин писал(а):... я с удовольствием это попробую приписать как мне видится, а вы поправьте или снесите, если не понравится...
Ок! Тогда я тебя подожду немного.
Аватара пользователя
Максим Дубинин
MindingMyOwnBusiness
Сообщения: 9129
Зарегистрирован: 06 окт 2003, 20:20
Репутация: 748
Ваше звание: NextGIS
Откуда: Москва
Контактная информация:

Re: RoadGraph_Docs

Сообщение Максим Дубинин »

я подправил - второе предложение, статье нужно добавить <p class="ann">Краткую аннотацию</p> в самом начале
пристегивайтесь, турбулентность прямо по курсу
stopa85

Re: RoadGraph_Docs

Сообщение stopa85 »

Максим Дубинин писал(а):я подправил - второе предложение, статье нужно добавить <p class="ann">Краткую аннотацию</p> в самом начале
Добавлено.
Ответить

Вернуться в «Материалы сайта»

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и 2 гостя