Временная страница для тестов -- SettingsStuffPage | Залогиниться -- Special:UserLogin
Обсуждаемо! :) Названия и описания разделов рабочие, будут корректироваться по мере наполнения.
Getting Started
Вольный стиль. Схемы. О чем мы тут. Общая идея движка. Возможности. Системные требования и требования к пользователю (программисту). Совсем поверхностная структура. Установка и настройка. Описание интерфейса (GUI, CLI).
How does it work?
Вольный стиль. Схемы. Основные настраиваемые параметры. Общие принципы работы. Общее описание структуры (иерархия подсистем, их назначение, как они работают для программиста). Здесь же чуть глубже описание сложных подсистем - рендера, физики, UI, файловой системы и т.п. с разбором их структуры и возможностей управления.
Let's use it!
Смешанный стиль (вольная вводная часть, инструкции, код и т.п., как пойдет). Основной раздел (в этой части можно взять за основу структуру доки UNITY). Подробное описание для разработчика приложений. В отличие от How does it work? делается упор на практическую полезность для программиста и четкие инструкции, а не общую информацию об устройстве движка. Сгруппировано по общим направлениям работы (программирование UI, AI, анимация, аудио и т.п., отдельно можно рассказать про специфику (различия для платформ и назначения приложения в целом (игра, реклама и т.п.))).
List of Objects
Справочник. Структурированный перечень элементов, которые можно использовать (ноды, свет и т.п.). Возможно вольное описание нестандартных объектов или нестандартного использования.
Just a few modules
Справочник. Структурированное описание всех программных модулей движка (в каждом ссылка на API и пример использования). В отличие от List of Objects здесь описываются программные модули, а не механики и объекты игрового мира (но если описания совпадают, будет редирект).
Need some API?
Только таблицы. Помодульное описание API (ссылки на эти статьи должны быть доступны из архитектурного описания модулей).
Content Creation
Инструкции и/или требования. Описание процесса разработки ассетов (если это нам надо, или просто требования к создаваемым ассетам).
We have tools!
Технические описания. Инструменты (внешние относительно движка, но разработанные нами) доступные разработчику. Здесь же подразделом могут быть сторонние инструменты, которые удобно использовать с нашим движком. Но, возможно, крупные инструменты, такие как редакторы чего-то, придется вынести совсем наверх.
Sets of examples
Код и ссылки. Примеры сгруппированные по кейсам (и для каждого описанного модуля должна быть ссылка на такой пример).
Best practices
Свободный стиль. Гайды для продвинутых. В зависимости от содержания, можно объединить с Let's use it!
Videoguides
Если будут)
Games and Ads
Портфолио работ на движке.
In development
Свободный стиль. Новые фичи в разработке (в отличие от новостей, здесь дается подробное описание того, что пока не доступно).