Организация запросов Data Explorer сообщества

Похоже, что на meta.discourse.org в данный момент нет живой библиотеки запросов для Data Explorer. Стоит ли уделить внимание этому вопросу?

Тема, на которую здесь ссылаются, была неструктурированной и закрыта, так как представляла собой хаос:

@SidV создал отличную коллекцию на GitHub:
discourse-data-explorer/querys.md at queries · SidVal/discourse-data-explorer · GitHub

Не пора ли создать здесь, на Meta, библиотеку под управлением сообщества? Я думаю, что многим это было бы полезно.

10 лайков

Да, в той теме было так много вопросов и ответов, что её стало невозможно читать.

Я тоже так думаю. Есть ли у кого-нибудь идеи о том, как лучше всего организовать запросы Data Explorer на этом сайте? В идеале должна быть возможность находить существующие запросы, вводя несколько ключевых слов.

6 лайков

Несколько мыслей:

  1. Мы могли бы создать отдельную категорию с одним запросом на тему. Это могло бы требовать одобрения со стороны сотрудников для новых тем, чтобы избежать беспорядка.
  2. Мы могли бы просто использовать тег data-explorer-query для отдельных тем. Эти темы могли бы находиться в разделе #howto:tips-and-tricks.
10 лайков

Спасибо, что пригласили меня выступить :relaxed:

Я открыт к изменению классификации списка запросов на GitHub. Возможно, если мы все вместе подумаем над классификацией, то после отладки категорий сможем перенести это сюда, в Meta (?).

Не стесняйтесь создавать PR.

5 лайков

Я не знал, что каждый запрос можно оформить как PR, форкнуть и т. д. Это довольно круто, и я понимаю, почему вы так сделали. Однако для менее технически подкованных людей это может быть запутанным местом. Все администраторы Discourse знакомы с Discourse, но лишь часть из них знакома с GitHub.

Что вы имеете в виду под классификацией? Я думаю, что для этого хорошо подойдут теги.

Я считаю, что лучшим вариантом будет выделение отдельной подкатегории в Customization > Plugin.

  1. Если мы решим сделать одну тему на запрос, тем будет очень много. У @SidV уже более 70, а таких запросов в сети гораздо больше. Это значительно засорит/затопит раздел #howto:tips-and-tricks!
  2. Это позволит сделать каждую тему вики-страницей, настроить переход к первому сообщению и использовать предложенную структуру в качестве шаблона.
  3. Это также будет соответствовать конфигурации категории Customization > Plugin, что просто отлично!
2 лайка

Я предлагаю перенести все полезные и эффективные запросы в одну тему, а затем закрыть её.

Эта тема станет «единым источником правды» для проверенных запросов.

Затем мы можем быть более строгими к структуре записей, добавляемых в эту тему. Каждая запись будет иметь заголовок с описанием, краткое пояснение о её назначении и упоминание автора для указания заслуг.

После этого мы сможем добавить в эту тему оглавление, где каждому запросу будет соответствовать свой заголовок.

Чтобы ответить на обеспокоенность Саймона, озвученную здесь:

Новая версия компонента оглавления будет включать строку поиска в реальном времени прямо внутри поста. Она будет искать по заголовкам и содержимому каждого раздела и выглядеть следующим образом:

(пока что игнорируйте стили, это всё ещё находится в разработке)

Новая версия, скорее всего, будет готова к использованию в продакшене к концу года.

Что касается процесса обмена, предложения или запроса новых запросов, мы можем создать для этого отдельную тему. Хорошие запросы, размещённые в этой теме, будут затем добавляться в тему «единый источник правды», содержащую оглавление.

7 лайков

На мой взгляд, более целесообразным было бы разработать процесс упаковки запросов в Data Explorer.

Можно создать Contribute > Feature с тегом data-explorer #candidate-query, содержащий запрос-кандидат. В описании функции следует объяснить, почему его следует объединить, а также чем он уникален и важен.

Затем мы решаем, является ли предложение обоснованным, объединяем запрос и закрываем тему.

При желании вы всегда можете просмотреть отклонённые запросы на объединение.

8 лайков

Расширение набора запросов, доступных в Data Explorer по умолчанию, безусловно, было бы очень полезным и удобным для многих администраторов и пользователей.

Однако, я считаю, что также существует потребность в запросах «второго уровня» и в структурированном месте для их обсуждения. Я прихожу на Meta в поисках решения своей проблемы, а не чтобы жертвовать собственные умные запросы как таковые.

Возможно, подходы @sam и @Johani можно было бы объединить? Например, создать подкатегорию с темами/запросами, помеченными как «официальные», которые будут включены в плагин.

1 лайк

Небольшое обновление по этому вопросу — у нас теперь есть категория #data-reporting. :tada: :slight_smile:

Я перечитаю предложения в этой теме и посмотрю, есть ли ещё идеи, которые я могу позаимствовать. :slight_smile:

5 лайков

Продолжение обсуждения на Could we re-open the topic to share Explorer queries?