Size: a a a

Combot Россия

2019 October 04

Akcium Сергей in Combot Россия
Vadim Sterkin
так я и рецензирую, там же нельзя откомментировать :)
на счет описания, дайте мысль, как лучше подписать?
источник

VS

Vadim Sterkin in Combot Россия
Vadim Sterkin
так я и рецензирую, там же нельзя откомментировать :)
вот это https://telegra.ph/CHto-umeet-Combot-09-27 не очень полезно. Потому что обилие скриншотов:
1. Просто дублирует то, что видит пользователь в настройках, не давая дополнительной ценности. В принципе, там хорошие объяснения прямо на страницах, надо их дорабатывать, если необходимо.
2. По мере изменения интерфейса скриншоты устаревают, что смущает пользователя. Он сопоставляет справку с интерфейсом и путается. Ну и автор взваливает на себя обязанность обновлять скриншоты регулярно.
источник

Akcium Сергей in Combot Россия
Vadim Sterkin
вот это https://telegra.ph/CHto-umeet-Combot-09-27 не очень полезно. Потому что обилие скриншотов:
1. Просто дублирует то, что видит пользователь в настройках, не давая дополнительной ценности. В принципе, там хорошие объяснения прямо на страницах, надо их дорабатывать, если необходимо.
2. По мере изменения интерфейса скриншоты устаревают, что смущает пользователя. Он сопоставляет справку с интерфейсом и путается. Ну и автор взваливает на себя обязанность обновлять скриншоты регулярно.
это актуально, ибо многие спрашивают а что комбот умеет?
источник

Akcium Сергей in Combot Россия
Vadim Sterkin
вот это https://telegra.ph/CHto-umeet-Combot-09-27 не очень полезно. Потому что обилие скриншотов:
1. Просто дублирует то, что видит пользователь в настройках, не давая дополнительной ценности. В принципе, там хорошие объяснения прямо на страницах, надо их дорабатывать, если необходимо.
2. По мере изменения интерфейса скриншоты устаревают, что смущает пользователя. Он сопоставляет справку с интерфейсом и путается. Ну и автор взваливает на себя обязанность обновлять скриншоты регулярно.
и пожалуйста, замечания по делу :)
Пустая болтовня мало кого интересует :)
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
на счет описания, дайте мысль, как лучше подписать?
не помню синтаксис телеграфа, но примерно так
## Административные команды
Эти команды работают только у администраторов чата.

### Управление участниками и сообщениями
Все команды выполняются посредством ответа на сообщение участника чата. (дальше по тексту вплоть до первой черты, сюда же ro кинуть)

### Диагностические команды
(сюда  cdoctor, reload_admins)

### Быстрый переход в настройки
log,mod,cfg

TBC
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
и пожалуйста, замечания по делу :)
Пустая болтовня мало кого интересует :)
я же по делу сразу сказал, если я говорю, что надо структурировать текст заголовками - это не болтовня
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
это актуально, ибо многие спрашивают а что комбот умеет?
ок
источник

Akcium Сергей in Combot Россия
Vadim Sterkin
я же по делу сразу сказал, если я говорю, что надо структурировать текст заголовками - это не болтовня
заголовки, да, дельно.
А вот что нужно, что не нужно, кто чем себя обременяет, и где должно быть, пожалуй, излишне)
источник

VS

Vadim Sterkin in Combot Россия
Vadim Sterkin
не помню синтаксис телеграфа, но примерно так
## Административные команды
Эти команды работают только у администраторов чата.

### Управление участниками и сообщениями
Все команды выполняются посредством ответа на сообщение участника чата. (дальше по тексту вплоть до первой черты, сюда же ro кинуть)

### Диагностические команды
(сюда  cdoctor, reload_admins)

### Быстрый переход в настройки
log,mod,cfg

TBC
## Пользовательские команды
Это список "другие команды"
## Команды для личного общения с ботом
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
заголовки, да, дельно.
А вот что нужно, что не нужно, кто чем себя обременяет, и где должно быть, пожалуй, излишне)
Послушай (перейду на ты, сорри), у меня большой опыт работы в сфере технических руководств для конечных пользователей. И я вижу, что твой документ унылый.

Поэтому я подсказываю тебе, как структурировать и логически организовать материал. Ты можешь не соглашаться с тем, принадлежит ли та или иная команда к какой-то группе. Но если ты отметаешь все оптом, то я просто сворачиваю разговор.
источник

Akcium Сергей in Combot Россия
Vadim Sterkin
Послушай (перейду на ты, сорри), у меня большой опыт работы в сфере технических руководств для конечных пользователей. И я вижу, что твой документ унылый.

Поэтому я подсказываю тебе, как структурировать и логически организовать материал. Ты можешь не соглашаться с тем, принадлежит ли та или иная команда к какой-то группе. Но если ты отметаешь все оптом, то я просто сворачиваю разговор.
я не отметаю оптом, а лишь прошу разграничить на то что нужно, и то, что излишне будет.
1. Внешний вид, разметка, структуризация, это актуально, и нужно.
2. Кто это должен делать, где должно размещаться, что "полезно", а что "не полезно", это уже излишне.

Я сижу в чате постоянно, и вижу какие вопросы задаются, и при всем уважении, я вижу спрос на тот или иной материал.
источник

Akcium Сергей in Combot Россия
Vadim Sterkin
## Пользовательские команды
Это список "другие команды"
## Команды для личного общения с ботом
буду признателен за образец оформления подобных статей
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
я не отметаю оптом, а лишь прошу разграничить на то что нужно, и то, что излишне будет.
1. Внешний вид, разметка, структуризация, это актуально, и нужно.
2. Кто это должен делать, где должно размещаться, что "полезно", а что "не полезно", это уже излишне.

Я сижу в чате постоянно, и вижу какие вопросы задаются, и при всем уважении, я вижу спрос на тот или иной материал.
возможно, я недооценил полезность всех этих скриншотов для тех, кто еще не начал пользоваться ботом и почему-то не хочет попробовать :) ок, ты принял к сведению, но сделал как нужно.
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
буду признателен за образец оформления подобных статей
у меня нет образцов в телеграфе, но открываешь первую ссылку в моем блоге и видишь структуру, оформление, логику http://www.outsidethebox.ms/19657/
источник

Akcium Сергей in Combot Россия
будь это сайт, то и разговор был бы иной.
Возможности телеграфа сильно ограничены, и это очень весомый фактор
источник

VS

Vadim Sterkin in Combot Россия
Akcium Сергей
будь это сайт, то и разговор был бы иной.
Возможности телеграфа сильно ограничены, и это очень весомый фактор
такую структуру как я показал можно сделать в телеграфе без проблем, вот же она https://telegra.ph/combot-regex-compilation-ru-08-24
источник

Akcium Сергей in Combot Россия
по категориям такое можно и нужно делать, согласен.
Когда идет описание каждой категории отдельно.
Но, когда идет общее описание возможностей, такое оформление боюсь увеличит объем раза в 2-3.
источник

VS

Vadim Sterkin in Combot Россия
я не понимаю, откуда там возьмется увеличение. Тот же список команд, просто с заголовками и чуть другой логикой. Но спорить не буду, нет смысла тратить на это время :)
источник

Akcium Сергей in Combot Россия
*Команды я закончил только сегодня утром, я не успел их еще привести в порядок)
источник

Akcium Сергей in Combot Россия
Vadim Sterkin
я не понимаю, откуда там возьмется увеличение. Тот же список команд, просто с заголовками и чуть другой логикой. Но спорить не буду, нет смысла тратить на это время :)
с командами вопросов нет, правда за вами)
источник