К содержанию
fohbook

fohbook · происхождение текста

Как это написано

fohbook — база руководств по железу и софту из райдеров: 56 позиций в каталоге, 720 статей в открытых гайдах. У каждого гайда два источника с разной надёжностью, и на готовый гайд может встать отметка о том, что его прочитал практик. Дальше — что откуда берётся и что означает эта отметка.

  1. 01
    Источник

    Документация производителя либо опыт практиков, опубликованный в интернете

  2. 02
    Структурирование

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

  3. 03
    Чтение

    Готовый гайд читает инженер, который работает на этом пульте

  4. 04
    Отметка

    Несоответствий не нашёл — на гайде встаёт его имя

Из чего собран гайд

Материал в статье неоднороден, и путать его части дорого. Одна проверяется ссылкой, вторая — только вашим пультом.

Ядро

официальная документация

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

Утверждение из ядра проверяемо. У него есть источник, а там, где поведение зависит от версии ПО, в тексте стоит номер версии — оборот «зависит от прошивки» без номера сборка не пропускает.

как проверитьмануалом производителя и номером версии

Дополнительные материалы

опыт практиков

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

Надёжность здесь ниже, и причина понятна. Человек описывал свою площадку, свою версию прошивки и свой случай; формулировка могла быть неточной, обстоятельства — другими, а с тех пор вышло три релиза. Такой материал — повод попробовать у себя. Ссылаться на него как на документацию нельзя.

как проверитьтолько на своём пульте

Отметка «проверено специалистом»

Проверено специалистом

Готовый гайд читает практикующий инженер — человек, который работает на этом пульте сейчас. Нашёл несоответствие — статью правим. Не нашёл — на гайд встаёт отметка с его именем, профессией и датой.

что она значит

Человек из актуальной профессии это читал и несоответствий не нашёл.

чего она не значит

Отметка никого ни к чему не обязывает и ничего не гарантирует. Она не делает проверявшего автором текста и не переносит на него ответственность за то, что вы сделаете на площадке. Это подпись читателя.

Где она стоит сейчас

Отметки пока нет ни на одном гайде.

Почему под статьями нет подписи

Текст пишет нейросеть, и имя человека под ним означало бы авторство, которого нет. По той же причине переключатель изложений в шапке статьи подписан «как коллега» и «как учебник»: оба текста написаны одинаково, и кнопки «человек» и «нейросеть» были бы неправдой. Отметка о проверке говорит про другое — про то, кто это читал.

Что проверяет машина

У корпуса есть линтер стиля и тесты линейки версий. Они держат счётные вещи: не пускают оценочные слова, обещания и заявления об авторстве, ловят текст, собранный по одной выкройке, следят, чтобы номер версии стоял там, где поведение от версии зависит. Правда ли написанное, машина не проверяет — для этого и нужен человек с опытом.

Почему свет впереди

Человек в проекте сейчас один: оператор нейросети и практикующий мультимедиа-инженер, больше десяти лет на площадках. Специализация — свет, пульты grandMA2 и grandMA3.

Отсюда очередь правок. Новое правило, разметка версий, сверка спорного места с мануалом — сначала grandMA2 и grandMA3, потом остальные гайды. Так будет, пока у раздела не появится свой ответственный.

Кого не хватает

Практиков, готовых прочитать гайд по своему направлению и сказать, где он расходится с площадкой. Это может быть одна проверка. Может — постоянная модерация раздела: тогда очередь правок по нему определяет человек, который в нём работает.

Денег в проекте нет ни в одну сторону: материал открыт и никому не продаётся, за проверку платить нечем. Причина делать это так — состояние русскоязычной документации по такому железу. Её мало, и цех в СНГ учится с чужих слов и с чужих ошибок.

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