Сила технических документов: обеспечение контроля качества в криптоиндустрии

Сила технических документов: обеспечение контроля качества в криптоиндустрии

29 марта 2023 г.

Криптоиндустрия славится скоростью инноваций.

Проекты могли перейти от концепции к продукту за одну ночь. Нет веб-сайта? Дискорда нет? Нет белой бумаги? Нет проблем…

В течение последнего цикла бычьего рынка слабая дегенеративная природа криптовалюты стала ключевым моментом индустрии; обоюдоострый меч, который вдохновил на быструю итерацию, но ослепил от контроля качества.

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

Один из самых прагматичных, малоиспользуемых & Эффективный способ реализовать контроль качества в процессе принятия криптографических решений – это следить за вниманием проекта к деталям в своем техническом документе.

Что такое технический документ❔

Белая книга – это официальный маркетинговый/технический документ, предназначенный для краткого информирования читателей о сложном вопросе. помочь им понять позицию автора/организации по этому поводу.

Почему так важен технический документ❔

В конечном счете, наличие технических документов отличает лидеров мнений & выражает уверенность в знании предмета.

Белые книги служат основополагающей документацией бренда, которую можно использовать для неограниченного распространения информации о качестве. Они помогают читателям понять проблемы, решить проблемы и т.д. принимать решения.

Когда проект должен создавать свой технический документ ❔

Вчера!

Создание технического описания может занять и обычно требует очень много времени. Это интенсивный итеративный процесс, который может занять около 3 месяцев. Хотя можно что-то раскрутить за 7 дней, документу будет не хватать глубины; если это подход, который используется в проекте, это нормально, если документ обновляется по мере выполнения проекта.

Существуют ли различные типы технических документов ❔

Вообще говоря, существует 3 различных типа технических документов в зависимости от намерения:

-) общего назначения

-) Академический

-) Маркетинг

80% всех настоящих технических документов по криптографии будут академическими, 10% будут посвящены маркетингу и маркетингу. 10% будут общего назначения. Независимо от типа технического документа, который решит создать криптопроект или его отрасль, документ должен быть абсолютным источником контента.

Что входит в технический документ❔

Все!

Это мозги, мускулы и сила. красота.

Визуальное форматирование & брендинг важен, но сам по себе не определяет качество любого технического документа. Вы можете накрасить губы любой свинье.

Самым важным моментом в оценке качества любого технического документа является его содержание.

Содержание технического описания включает:

* техническое подробное письмо для описания сложных понятий. * Данные в виде диаграмм, графиков и т.д. рабочие процессы для поддержки идей. * макеты продукта * подробный &амп; хорошо изученные аргументы * &ампер; больше…

Необходим анализ рынка & отраслевое исследование, проведенное со всеми источниками/справками.

Конечно! Мы не можем забыть включить краткую копию в виде правильно расположенных идей / цитат по всему документу.

:::подсказка 🔑 — Ключевые указания для технического описания — 🔑

* Минимум # Количество слов: 2500 | Максимальное # количество слов: ~ 12 500 * Минимальное количество страниц: ~ 8 | Максимальное количество страниц: ~ 40 * Минимальное количество ссылок: ~ 5 | Максимальное количество ссылок: ~ 25 * Мин. # Визуальные данные: ~3 | Макс. количество визуальных данных: ~15

*Есть только эмпирические правила, и это абсолютно нормально.

:::


Структура технической документации по криптографии

  1. Титульная страница {1pg} Должна содержать название проекта, краткую крылатую фразу, описывающую нюансы темы& Дата выдачи. Маркетинг & Варианты общего назначения в идеале должны иметь некоторую форму брендинга/логотипа. Если это академический документ, визуальная презентация связана с форматированием, а не с брендингом, здесь обычно можно найти краткое изложение, размещенное впереди & центр.

    2. Страница указателя содержания{1pg}. Простой план структуры содержания с разбивкой по заголовку и заголовку. страница #. Если это не предусмотрено в технической документации, это абсолютно нормально, это не нарушение условий сделки; однако его наличие еще больше впечатлит публику.

    3. Интерлюдия {1pg} Некоторая форма контента, предвосхищающая информацию & задать тон документа. Это может быть «письмо от основателя», «одобрение» другого лидера отрасли или что-то более простое, например, конкретная «цитата» из истории.

    4. Введение {1–2pg} Хорошее введение обычно определяется его длиной. Здесь проект представляет предмет/продукт документа, кратко обсуждает текущее состояние рынка, кратко затрагивает проблемную область и т.д. заинтересовать читателя узнать больше.

    5. Основные сведения о рынке/теме {2-3pg} Тщательное исследование & анализ рынка является абсолютной основой качества технического описания. Этот раздел должен поддерживаться Data & включать большое количество внешних ссылок.

    6. Постановка задачи{1pg} Как упоминалось ранее в документе, постановка задачи требует отдельного раздела & следует следить за исследованием рынка. Если предыстория рынка/предмета была хорошо сформулирована, читатель должен сделать вывод о проблеме & раскрыть нюансы этой проблемы здесь.

    7. Решение(я) & Конкурентная среда {1–4pg} Еще один элемент, тесно связанный с исследованиями. существующие решения & их провайдеры должны быть отмечены & объяснил. Конкуренцию нужно решать. Возможные решения должны быть изложены & предложено.

    8. Техническая архитектура/архитектура смарт-контракта {1–3pg} Здесь описываются элементы технической реализации решения. Платформы/стеки технологий/API или операционные процедуры (т. е. пропускная способность механизма консенсуса).

    9. Токеномика {2–5pg} Этот раздел может быть представлен как отдельный документ, состоящий из:

    1. Выпуск & Распределение — использование ресурсов
    2. Эмиссия токенов
    3. График выпуска материалов
    4. Token Utility — применение/использование токена
    5. Стандарт токена — технические характеристики токена (ERC-20, BEP-20 и т. д.)
    6. Список токенов — запланировано и существующий
    7. Блокировка токенов – безопасность обращения
    8. Распределение средств — как будут использованы привлеченные средства.

    10. Организационная структура {1–2pg} Понимание того, как проект/продукт будет разрабатываться и развиваться. должны быть рассмотрены. Юридические последствия работы через DAO, фонд или VASP подчеркнут намерения основателей проекта & пролить свет на истинную «децентрализацию» предлагаемого решения.

    11. Команда {1pg} Стандартная практика в любой отрасли; предоставление изображений, фонов профилей, ссылок & контактная информация членов команды важна для обеспечения надлежащего профессионального имиджа и имиджа. выделиться в псевдонимном мире криптографии.

    12. Советники {1pg}

    Это не всегда необходимость, но определенно приятно. Наличие надежных людей с сильными

    репутация, поддерживающая ваше дело, всегда привлечет положительное внимание.

  1. Партнерские отношения {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.

  1. Дорожная карта/план игры{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

:::


Оригинал
PREVIOUS ARTICLE
NEXT ARTICLE