Сила технических документов: обеспечение контроля качества в криптоиндустрии
29 марта 2023 г.Криптоиндустрия славится скоростью инноваций.
Проекты могли перейти от концепции к продукту за одну ночь. Нет веб-сайта? Дискорда нет? Нет белой бумаги? Нет проблем…
В течение последнего цикла бычьего рынка слабая дегенеративная природа криптовалюты стала ключевым моментом индустрии; обоюдоострый меч, который вдохновил на быструю итерацию, но ослепил от контроля качества.
По мере того, как мы избавляемся от последствий последнего рыночного коллапса & подготовиться к быстрому вхождению в новую экономическую среду, крайне важно прилагать все больше усилий к нашим процессам принятия решений.
Один из самых прагматичных, малоиспользуемых & Эффективный способ реализовать контроль качества в процессе принятия криптографических решений – это следить за вниманием проекта к деталям в своем техническом документе.
Что такое технический документ❔
Белая книга – это официальный маркетинговый/технический документ, предназначенный для краткого информирования читателей о сложном вопросе. помочь им понять позицию автора/организации по этому поводу.
Почему так важен технический документ❔
В конечном счете, наличие технических документов отличает лидеров мнений & выражает уверенность в знании предмета.
Белые книги служат основополагающей документацией бренда, которую можно использовать для неограниченного распространения информации о качестве. Они помогают читателям понять проблемы, решить проблемы и т.д. принимать решения.
Когда проект должен создавать свой технический документ ❔
Вчера!
Создание технического описания может занять и обычно требует очень много времени. Это интенсивный итеративный процесс, который может занять около 3 месяцев. Хотя можно что-то раскрутить за 7 дней, документу будет не хватать глубины; если это подход, который используется в проекте, это нормально, если документ обновляется по мере выполнения проекта.
Существуют ли различные типы технических документов ❔
Вообще говоря, существует 3 различных типа технических документов в зависимости от намерения:
-) общего назначения
-) Академический
-) Маркетинг
80% всех настоящих технических документов по криптографии будут академическими, 10% будут посвящены маркетингу и маркетингу. 10% будут общего назначения. Независимо от типа технического документа, который решит создать криптопроект или его отрасль, документ должен быть абсолютным источником контента.
Что входит в технический документ❔
Все!
Это мозги, мускулы и сила. красота.
Визуальное форматирование & брендинг важен, но сам по себе не определяет качество любого технического документа. Вы можете накрасить губы любой свинье.
Самым важным моментом в оценке качества любого технического документа является его содержание.
Содержание технического описания включает:
* техническое подробное письмо для описания сложных понятий. * Данные в виде диаграмм, графиков и т.д. рабочие процессы для поддержки идей. * макеты продукта * подробный &амп; хорошо изученные аргументы * &ампер; больше…
Необходим анализ рынка & отраслевое исследование, проведенное со всеми источниками/справками.
Конечно! Мы не можем забыть включить краткую копию в виде правильно расположенных идей / цитат по всему документу.
:::подсказка 🔑 — Ключевые указания для технического описания — 🔑
* Минимум # Количество слов: 2500 | Максимальное # количество слов: ~ 12 500 * Минимальное количество страниц: ~ 8 | Максимальное количество страниц: ~ 40 * Минимальное количество ссылок: ~ 5 | Максимальное количество ссылок: ~ 25 * Мин. # Визуальные данные: ~3 | Макс. количество визуальных данных: ~15
*Есть только эмпирические правила, и это абсолютно нормально.
:::
Структура технической документации по криптографии
-
Титульная страница {1pg} Должна содержать название проекта, краткую крылатую фразу, описывающую нюансы темы& Дата выдачи. Маркетинг & Варианты общего назначения в идеале должны иметь некоторую форму брендинга/логотипа. Если это академический документ, визуальная презентация связана с форматированием, а не с брендингом, здесь обычно можно найти краткое изложение, размещенное впереди & центр.
2. Страница указателя содержания{1pg}. Простой план структуры содержания с разбивкой по заголовку и заголовку. страница #. Если это не предусмотрено в технической документации, это абсолютно нормально, это не нарушение условий сделки; однако его наличие еще больше впечатлит публику.
3. Интерлюдия {1pg} Некоторая форма контента, предвосхищающая информацию & задать тон документа. Это может быть «письмо от основателя», «одобрение» другого лидера отрасли или что-то более простое, например, конкретная «цитата» из истории.
4. Введение {1–2pg} Хорошее введение обычно определяется его длиной. Здесь проект представляет предмет/продукт документа, кратко обсуждает текущее состояние рынка, кратко затрагивает проблемную область и т.д. заинтересовать читателя узнать больше.
5. Основные сведения о рынке/теме {2-3pg} Тщательное исследование & анализ рынка является абсолютной основой качества технического описания. Этот раздел должен поддерживаться Data & включать большое количество внешних ссылок.
6. Постановка задачи{1pg} Как упоминалось ранее в документе, постановка задачи требует отдельного раздела & следует следить за исследованием рынка. Если предыстория рынка/предмета была хорошо сформулирована, читатель должен сделать вывод о проблеме & раскрыть нюансы этой проблемы здесь.
7. Решение(я) & Конкурентная среда {1–4pg} Еще один элемент, тесно связанный с исследованиями. существующие решения & их провайдеры должны быть отмечены & объяснил. Конкуренцию нужно решать. Возможные решения должны быть изложены & предложено.
8. Техническая архитектура/архитектура смарт-контракта {1–3pg} Здесь описываются элементы технической реализации решения. Платформы/стеки технологий/API или операционные процедуры (т. е. пропускная способность механизма консенсуса).
9. Токеномика {2–5pg} Этот раздел может быть представлен как отдельный документ, состоящий из:
- Выпуск & Распределение — использование ресурсов
- Эмиссия токенов
- График выпуска материалов
- Token Utility — применение/использование токена
- Стандарт токена — технические характеристики токена (ERC-20, BEP-20 и т. д.)
- Список токенов — запланировано и существующий
- Блокировка токенов – безопасность обращения
- Распределение средств — как будут использованы привлеченные средства.
10. Организационная структура {1–2pg} Понимание того, как проект/продукт будет разрабатываться и развиваться. должны быть рассмотрены. Юридические последствия работы через DAO, фонд или VASP подчеркнут намерения основателей проекта & пролить свет на истинную «децентрализацию» предлагаемого решения.
11. Команда {1pg} Стандартная практика в любой отрасли; предоставление изображений, фонов профилей, ссылок & контактная информация членов команды важна для обеспечения надлежащего профессионального имиджа и имиджа. выделиться в псевдонимном мире криптографии.
12. Советники {1pg}
Это не всегда необходимость, но определенно приятно. Наличие надежных людей с сильными
репутация, поддерживающая ваше дело, всегда привлечет положительное внимание.
-
Партнерские отношения {1pg}
Скорее всего, чтобы проект был успешным, его должны принять многие люди. Партнерские отношения — это наиболее эффективный механизм запуска в арсенале создания сообщества.
14. Аудит
Audits are one of the most desirable things to look for in a whitepaper. If a project has completed an audit of its smart contract(s) that shows a high level of commitment to quality. More likely than not, a serious project that raises money has conducted some form of audit.
-
Дорожная карта/план игры{1pg} Важно. Если в техническом документе этого нет, это непростительный красный флаг. Должна быть предоставлена дорожная карта, не обязательно идеально следовать ей, но иметь сильное чувство направления. Это нормально, если что-то завершается в другом ритме, чем то, что написано, но основное правило заключается в том, что в какой-то момент все должно быть достигнуто (если только проект не изменится).
16. Заключение {1–2pg} Это последний блок содержания, который должен обобщать все ключевые моменты, обсуждавшиеся в документе & выразить предположение о том, что впереди.
17. Ссылки{1pg} Возможно, самый недооцененный элемент любого технического документа. Ссылки дадут представление о качестве исследований и исследований. комплексная проверка, проводимая проектом. Чем меньше ссылок, тем менее достоверной будет информация в документе. Обычно ссылки размещаются в последнем или предпоследнем разделе технического описания.
18. Ресурсы и ресурсы Ссылки {1pg} Одна из последних страниц технического описания, ресурсы & Раздел ссылок даст читателям возможность узнать больше о проекте. Не забудьте включить ссылки на официальный веб-сайт, блоги, каналы социальных сетей, торговые пулы, обозреватели смарт-контрактов в сети и amp; все, что может иметь значение.
📜 — Вдохновляющие примеры технических документов —📜
💜 Космос: https://v1.cosmos.network/resources/whitepaper
💖 Лавина: https://www.avalabs.org/whitepapers
💗 Polkadot: https://polkadot.network/whitepaper/
🖤 Algorand: https://www.algorand.com/technology/white-papers
Спасибо, что прочитали,
Надеюсь, это поможет!
Увидимся на следующем бычьем рынке!!
Также опубликовано здесь
:::подсказка Если у вас есть вопросы или вам нужна помощь в создании собственного технического описания, свяжитесь со мной: https://linktr.ee/andreydidovskiy
:::
Оригинал