Size: a a a

GraphQL — русскоговорящее сообщество

2020 November 26

EA

El Anonimo in GraphQL — русскоговорящее сообщество
Пардон, если длинно.
источник

S

Strayko in GraphQL — русскоговорящее сообщество
Pavel @nodkz
Немного не в тему GraphQL, но в тему следующих хайповых технологий.

Завтра на HolyJS буду рассказывать про Module Federation. Эта новая архитектура, которая позволяет собирать микрофронтенды. Простым языком – это когда код разбросан по нескольким репкам и командам, и только в браузере, в рантайме, приложение собирается в один сплошной монолит.

Ссылка на слайды про Module Federation (много ссылок на доп материал):

🔥 http://bit.ly/module-federationhttp://bit.ly/module-federation 🔥

Буду признателен, если найдете орфографические ошибки и скините мне в личку.

Про доклад тут:
https://holyjs-moscow.ru/2020/msk/talks/5xx2i0vcleyeatztadt6ap/
а есть на гитхабе примеры таких проектов ?)
источник

P@

Pavel @nodkz in GraphQL — русскоговорящее сообщество
Там в презентации на предпоследних слайдах есть ссылка на репку как минимум с 30 разными ревлизациями
источник

P@

Pavel @nodkz in GraphQL — русскоговорящее сообщество
Живых проектов в проде я пока не встречал. Module Federation только в октябре зарелизился вместе с 5тым вебпаком
источник

P@

Pavel @nodkz in GraphQL — русскоговорящее сообщество
Хотя вчера я уже у нас запустил альфа версию нашей будущей системы. Пока тесттим смотрим.
источник
2020 November 27

АН

Анатолий Нечай-Гумен... in GraphQL — русскоговорящее сообщество
Коллеги, всем привет
Подскажите, кто как документирует своё API? Понимаю, что схема сама по себе документация, но хочется оформить в виде сайта с примерами запросов и процессами, в идеале с возможностью потыкать запросы прям там. Подозреваю, что придётся делать самому что-то вроде плагина к анторе для такого, но может быть есть готовое решение?
источник

EA

Eugene Allenov in GraphQL — русскоговорящее сообщество
Анатолий Нечай-Гумен
Коллеги, всем привет
Подскажите, кто как документирует своё API? Понимаю, что схема сама по себе документация, но хочется оформить в виде сайта с примерами запросов и процессами, в идеале с возможностью потыкать запросы прям там. Подозреваю, что придётся делать самому что-то вроде плагина к анторе для такого, но может быть есть готовое решение?
А чем playground не устраивает
источник

АН

Анатолий Нечай-Гумен... in GraphQL — русскоговорящее сообщество
Eugene Allenov
А чем playground не устраивает
Задача то именно в документации с примерами запросов и процессов, для публичного API. Невежливо как-то кидаться в клиентов и партнёров Playground-ом - мол, разбирайтесь сами)
источник

EA

Eugene Allenov in GraphQL — русскоговорящее сообщество
Так если задачи сделать примеры - так и надо высылать примеры.

А если нужно описание ВСЕХ запросов - то в плейграунде каждый запрос и поле по правилам хорошего сопровождаются комментариями, которые в этом же плейграунде видны при интроспекции схемы
источник

RL

Roman Lykov in GraphQL — русскоговорящее сообщество
Анатолий Нечай-Гумен
Коллеги, всем привет
Подскажите, кто как документирует своё API? Понимаю, что схема сама по себе документация, но хочется оформить в виде сайта с примерами запросов и процессами, в идеале с возможностью потыкать запросы прям там. Подозреваю, что придётся делать самому что-то вроде плагина к анторе для такого, но может быть есть готовое решение?
Можно сделать генерацию тайпингов с хуками, там будут примеры под каждый запрос
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
Анатолий Нечай-Гумен
Коллеги, всем привет
Подскажите, кто как документирует своё API? Понимаю, что схема сама по себе документация, но хочется оформить в виде сайта с примерами запросов и процессами, в идеале с возможностью потыкать запросы прям там. Подозреваю, что придётся делать самому что-то вроде плагина к анторе для такого, но может быть есть готовое решение?
Если в схеме ко всем типам, полям, аргументам и т.д. написаны описания (GraphQL поддерживает Markdown), то существуют генераторы документации из GraphQL-схемы.

Например: https://github.com/OneGraph/graphql-codex
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
Живой пример: https://onegraph.com/schema/
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
Но по сути, в GraphQL документации и есть схема. Просто в human-readable виде.

Плюс примеры запросов (но их всё равно придётся придумывать интересные и прописывать вручную, автоматом интересные осмысленные запросы не сгенерировать).

GraphiQL во вкладке Docs нормально отображает схему.
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
GraphQL Voyager отображает схему в виде визуального графа:

https://github.com/APIs-guru/graphql-voyager
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
GraphiQL Explorer отображает схему в виде дерева (+ можно легко одними кликами мыши накликать всегда валидный запрос):

https://github.com/OneGraph/graphiql-explorer
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
источник

АР

Алексей Родионов... in GraphQL — русскоговорящее сообщество
Команда Apollo скоро добавит возможность сохранять в облаке GraphQL-запросы и давать им имена.

Получится, что документацию (схему с описаниями) посмотреть можно + можно будет заготовить интересных запросов, которые пользователь сможет взять, выполнить и поиграться с ними, поизменять.
источник

П

Павел) in GraphQL — русскоговорящее сообщество
Всем привет! Подскажите пожалуйста как в Apollo юзать enum ?
источник

П

Павел) in GraphQL — русскоговорящее сообщество
Павел)
Всем привет! Подскажите пожалуйста как в Apollo юзать enum ?
источник