Недостающая первая миля: онбординг в Gonka с точки зрения новичка
Оригинал: The missing first mile: onboarding Gonka from a newcomer’s perspective
Эй, Жюльен! Спасибо большое, что поделились своим опытом и идеями! Я бы предложил также обратить внимание на эту проблему в Discord сообщества Gonka (ссылки сюда не оставлять, но вы найдете это в README).
Привет @julb1992 (https://github.com/julb1992)! Взгляните на недавно обновленный сайт https://gonka.ai/. Думаешь, сейчас лучше? Кстати, документация сайта размещена в общедоступном репозитории https://github.com/gonka-ai/gonka-docs, поэтому любой может предложить изменения, отправив запрос на включение.
Спасибо! Я определенно думаю, что это улучшение.
Это фактически подтверждает мысль, которую я пытался донести в своем посте «пропущенная первая миля».
Документация для разработчиков становится лучше, и это здорово.
Но я все еще думаю, что людям, которые не являются разработчиками или поставщиками графических процессоров, чего-то не хватает.
Я прихожу в Gonka как инвестор, который пытается по-настоящему понять проект, и, честно говоря, мне потребовались недели чтения постов на GitHub, Discord, Medium и общения с людьми из сообщества, прежде чем все начало обретать смысл. И даже сейчас я все еще не чувствую, что имею полную картину.
На самом деле я пишу свой собственный документ, просто чтобы правильно понять экосистему, и думаю, что в конечном итоге он будет состоять из нескольких десятков страниц. Наверное, это говорит о многом.
Как все сочетается друг с другом, как работает сеть, где подходит токен, ключевые показатели и несколько реальных вариантов использования.
Разработчикам нужна документация. Людям, открывающим Gonka, нужна более широкая картина.
Мотивация
За последние две недели я потратил немало времени, пытаясь понять Gonka как нетехнического новичка.
Впервые я узнал о Gonka через GNK. Отсюда я попытался понять полную экономическую и техническую модель: хосты, экономику графических процессоров, PoC, залог, передачу прав, GNK против WGNK, мосты, HeX, NOP, шлюзы, брокеры, devshards и, наконец, фундаментальную роль разработчиков в сетевой экономике.
Информация существует. Документация обширна.
Проблема, с которой я столкнулся, была в другом: будучи новичком, я не знал, какие вопросы задавать, в каком порядке или какие концепции мне нужно понять в первую очередь.
Мне потребовалось почти две недели активных исследований, чтобы построить четкую мысленную модель Gonka.
Я считаю, что перед технической документацией может быть недостающий слой: «первая миля».
Gonka естественным образом объясняют люди, которые уже понимают Gonka. Новичкам может понадобиться объяснение Gonka с точки зрения того, кто ее открыл.
Решение высокого уровня
Создайте очень простой уровень адаптации на основе трех начальных этапов:
Я хочу использовать ИИ
Шлюз → Ключ API → модели → первый вывод.
Я хочу предоставить вычисления
Требования к оборудованию → Экономика хоста → NOP → первый PoC.
Я хочу понять ГНК
GNK vs WGNK → кошелек → бридж → залог → вестинг → ликвидность.
Целью не будет замена или переписывание технической документации Gonka.
Целью будет помочь новичку понять, с чего начать и что изучать дальше, а затем в нужный момент направить его к существующей документации.
Дорожная карта реализации
На данном этапе я не подаю заявку на финансирование.
Я бы сначала предложил:
- Задокументируйте точное путешествие новичка и вопросы, с которыми я столкнулся за последние две недели.
- Нанесите на карту основные точки разногласий и моменты замешательства.
- Создайте простой прототип трех этапов адаптации.
- Проверьте это на людях, которые никогда не использовали Gonka.
- Измерьте время до первого успешного действия: первого вывода, первой собственной транзакции GNK или четкого понимания пути Host/NOP.
Если сообщество осознает проблему, это может стать небольшим, измеримым пилотным проектом по адаптации.
Открытые вопросы
Признают ли существующие участники эту проблему адаптации?
Создаются ли уже подобные инициативы по адаптации?
Какой путь новичка в настоящее время создает больше всего проблем: разработчик, хост или пользователь GNK?
Увидит ли сообщество ценность в тестировании уровня адаптации для новичков до выпуска официальной документации?
Кто я
Меня зовут Жюльен. Я живу во Франции и занимаюсь инвестициями и управлением бизнесом.
Я не инженер протоколов и не специалист по инфраструктуре искусственного интеллекта.
Именно такая перспектива стоит за этим предложением.
Я обнаружил в Gonka потенциального участника, глубоко заинтересовался ее экономической моделью и провел последние две недели, активно пытаясь понять сеть с первых принципов.
Я не предлагаю объяснить Gonka лучше, чем ее строители. Я предлагаю задокументировать вопросы, которые задают новички, прежде чем они поймут, что объясняют строители Gonka.
Я был бы искренне признателен за критические отзывы, прежде чем развивать эту идею дальше.
Эй, Жюльен! Спасибо большое, что поделились своим опытом и идеями! Я бы предложил также обратить внимание на эту проблему в Discord сообщества Gonka (ссылки сюда не оставлять, но вы найдете это в README).
Привет @julb1992 (https://github.com/julb1992)! Взгляните на недавно обновленный сайт https://gonka.ai/. Думаешь, сейчас лучше? Кстати, документация сайта размещена в общедоступном репозитории https://github.com/gonka-ai/gonka-docs, поэтому любой может предложить изменения, отправив запрос на включение.
Спасибо! Я определенно думаю, что это улучшение.
Это фактически подтверждает мысль, которую я пытался донести в своем посте «пропущенная первая миля».
Документация для разработчиков становится лучше, и это здорово.
Но я все еще думаю, что людям, которые не являются разработчиками или поставщиками графических процессоров, чего-то не хватает.
Я прихожу в Gonka как инвестор, который пытается по-настоящему понять проект, и, честно говоря, мне потребовались недели чтения постов на GitHub, Discord, Medium и общения с людьми из сообщества, прежде чем все начало обретать смысл. И даже сейчас я все еще не чувствую, что имею полную картину.
На самом деле я пишу свой собственный документ, просто чтобы правильно понять экосистему, и думаю, что в конечном итоге он будет состоять из нескольких десятков страниц. Наверное, это говорит о многом.
Как все сочетается друг с другом, как работает сеть, где подходит токен, ключевые показатели и несколько реальных вариантов использования.
Разработчикам нужна документация. Людям, открывающим Gonka, нужна более широкая картина.
Motivation
Over the past two weeks, I have spent a significant amount of time trying to understand Gonka as a non-technical newcomer.
I initially discovered Gonka through GNK. From there, I tried to understand the full economic and technical model: Hosts, GPU economics, PoC, collateral, vesting, GNK vs WGNK, bridging, HeX, NOP, gateways, brokers, devshards, and finally the fundamental role of Developers in the network economy.
The information exists. The documentation is extensive.
The problem I experienced was different: as a newcomer, I did not know which questions to ask, in which order, or which concepts I needed to understand first.
It took me almost two weeks of active research to build a clear mental model of Gonka.
I believe there may be a missing layer before the technical documentation: the “first mile.”
Gonka is naturally explained by people who already understand Gonka. Newcomers may need Gonka explained from the perspective of someone discovering it.
High-Level Solution
Build a very simple onboarding layer around three initial journeys:
I want to use AI
Gateway → API key → models → first inference.
I want to provide compute
Hardware requirements → Host economics → NOP → first PoC.
I want to understand GNK
GNK vs WGNK → wallet → bridge → collateral → vesting → liquidity.
The objective would not be to replace or rewrite Gonka’s technical documentation.
The objective would be to help a newcomer understand where to start and what to learn next, then route them to the existing documentation at the right moment.
Implementation Roadmap
At this stage, I am not submitting a funding request.
I would first propose to:
- Document the exact newcomer journey and questions I experienced over the last two weeks.
- Map the main friction points and moments of confusion.
- Build a simple prototype of the three onboarding journeys.
- Test it with people who have never used Gonka.
- Measure time to first successful action: first inference, first native GNK transaction, or a clear understanding of the Host/NOP path.
If the community recognises the problem, this could then become a small, measurable onboarding pilot.
Open Questions
Do existing contributors recognise this onboarding problem?
Are similar onboarding initiatives already being built?
Which newcomer journey currently creates the most friction: Developer, Host, or GNK user?
Would the community see value in testing a newcomer-first onboarding layer before the official documentation?
Who I am
My name is Julien. I am based in France and work in investment and business management.
I am not a protocol engineer or an AI infrastructure specialist.
That is precisely the perspective behind this proposal.
I discovered Gonka as a potential participant, became deeply interested in its economic model, and spent the last two weeks actively trying to understand the network from first principles.
I am not proposing to explain Gonka better than its builders. I am proposing to document the questions newcomers ask before they understand what Gonka’s builders are explaining.
I would genuinely appreciate critical feedback before taking this idea any further.
Hey Julien! Thank you so much for sharing your experience and ideas! I'd propose also bringing attention to this issue on Gonka community's Discord (not dropping links here, but you'll find it in the README)
Hi @julb1992 (https://github.com/julb1992) ! Have a look at the recently updated https://gonka.ai/ website. Do you think it’s better now? By the way, the website documentation is hosted in a public repository https://github.com/gonka-ai/gonka-docs , so anyone can suggest changes by submitting a pull request.
Thanks! I definitely think it’s a improvement.
It actually reinforces the point I was trying to make in my “missing first mile” post.
The documentation for developers keeps getting better, which is great.
But I still think there’s something missing for people who aren’t developers or GPU providers .
I’m coming at Gonka as an investor who’s trying to really understand the project , and honestly it has taken me weeks of reading GitHub, Discord, Medium posts and talking with people from the community before everything started to make sense. And even now, I still don’t feel like I’ve got the full picture.
I’m actually writing my own document just to understand the ecosystem properly, and I think it’s going to end up being a few dozen pages. That probably says a lot.
How everything fits together, how the network works, where the token fits in, the key metrics, and a few real-world use cases.
Developers need documentation. People discovering Gonka need the bigger picture.
Мотивация
За последние две недели я потратил немало времени, пытаясь понять Gonka как нетехнического новичка.
Впервые я узнал о Gonka через GNK. Отсюда я попытался понять полную экономическую и техническую модель: хосты, экономику графических процессоров, PoC, залог, передачу прав, GNK против WGNK, мосты, HeX, NOP, шлюзы, брокеры, devshards и, наконец, фундаментальную роль разработчиков в сетевой экономике.
Информация существует. Документация обширна.
Проблема, с которой я столкнулся, была в другом: будучи новичком, я не знал, какие вопросы задавать, в каком порядке или какие концепции мне нужно понять в первую очередь.
Мне потребовалось почти две недели активных исследований, чтобы построить четкую мысленную модель Gonka.
Я считаю, что перед технической документацией может быть недостающий слой: «первая миля».
Gonka естественным образом объясняют люди, которые уже понимают Gonka. Новичкам может понадобиться объяснение Gonka с точки зрения того, кто ее открыл.
Решение высокого уровня
Создайте очень простой уровень адаптации на основе трех начальных этапов:
Я хочу использовать ИИ
Шлюз → Ключ API → модели → первый вывод.
Я хочу предоставить вычисления
Требования к оборудованию → Экономика хоста → NOP → первый PoC.
Я хочу понять ГНК
GNK vs WGNK → кошелек → бридж → залог → вестинг → ликвидность.
Целью не будет замена или переписывание технической документации Gonka.
Целью будет помочь новичку понять, с чего начать и что изучать дальше, а затем в нужный момент направить его к существующей документации.
Дорожная карта реализации
На данном этапе я не подаю заявку на финансирование.
Я бы сначала предложил:
Если сообщество осознает проблему, это может стать небольшим, измеримым пилотным проектом по адаптации.
Открытые вопросы
Признают ли существующие участники эту проблему адаптации?
Создаются ли уже подобные инициативы по адаптации?
Какой путь новичка в настоящее время создает больше всего проблем: разработчик, хост или пользователь GNK?
Увидит ли сообщество ценность в тестировании уровня адаптации для новичков до выпуска официальной документации?
Кто я
Меня зовут Жюльен. Я живу во Франции и занимаюсь инвестициями и управлением бизнесом.
Я не инженер протоколов и не специалист по инфраструктуре искусственного интеллекта.
Именно такая перспектива стоит за этим предложением.
Я обнаружил в Gonka потенциального участника, глубоко заинтересовался ее экономической моделью и провел последние две недели, активно пытаясь понять сеть с первых принципов.
Я не предлагаю объяснить Gonka лучше, чем ее строители. Я предлагаю задокументировать вопросы, которые задают новички, прежде чем они поймут, что объясняют строители Gonka.
Я был бы искренне признателен за критические отзывы, прежде чем развивать эту идею дальше.