Служебная страница
Сделано
Данный раздел реструктурирован и переписан.
К удалению, или как архивная статья
Думаю Quest Navigator задвинуть в дальний угол, пока Некс не вернётся к разработке, или пока кто-то другой не возьмётся и не избавит Навигатор от текущих недостатков. В принципе, теперь есть qSpider, поэтому предлагаю сконцентрироваться на его описании. Ниже разделы навигатора.
Сделать
Жизненно необходим раздел справочного описания всех ключевых слов, системных переменных и синтаксем, как это сделано сейчас в справочнике "Как сделать?" с примерами, с большим количеством примеров. Фактически нужна, как мне кажется, по каждому ключевому слову статья, либо - операторы, функции, системные переменные, операции и т.д.
В связи с этим предлагаю в ключевые слова.указатель вставить все ключевые слова именно в виде таблички. Из этой таблички давать ссылки на разделы отдельно: основной справки, отдельно: справочника ключевых слов. Таким образом в wiki будет реализована и серия статей к обучению-ознакомлению и серия статей по операторам. В первую очередь нужно вносить изменения об операторах именно в раздел справочника ключевых слов, и уже потом в разделы основной справки, если это необходимо. Таким образом можно будет разгрузить основную справку от различных тонкостей и нюансов в работе операторов, функций и т.д., а нагрузить все эти тонкости на отдельные фрагменты справки, описывающие конкретные операторы функции и т.д. Ссылки из основной справки опять же можно бужет делаь имеено в раздел справочника-указателя.
Статья по навешиванию событий на различные объекты в qSpider, чтобы можно было управлять содержимым и делать "подвижный" интерфейс в qSpider. Короче, надо больше информации по qSpider.
Доработки навигации
Ссылки вперед/назад и сверху и снизу
К Nexу: выделение текущей страницы в левом меню.
К Nexу: баг - в левом меню выделяется жирным последняя отредактированная страница
К Nexу: нужна более заметная ссылка на вики в разделе сайта "Разработчикам".
Сделать выделение символов ~&!%*^|-+=,./?<>;:()[]{}
в sxh.
Впихнуть куда-нибудь статью "Как писать игры" - в каком порядке удобнее обдумывать и писать, что изначально лучше локации прописать на листочке и т.п.
Самоучители
-
Подумать/обсудить
-
Самоучители - отдельный неймспейс, отдельные неймспейсы или howto?
Как хранить файлы с примерами кода, там же или перезалить в wiki (все яйца в одну корзину)?
Возможно статью "Известные баги"
Возможно отдельные статьи по концепциям "блоков кода" <и "переменных с двумя значениями"> переменные с двумя значениями больше не актуальны. Отдельная статья по блокам кода актуальна.
-
В какой момент обрабатываются подвыражения?
На странице циклов сделать примеры циклов do-while и while-do.
Статьи вне меню
Добавить в меню обязательно обновлённые лицензии
После раздела утилиты и средства разработки вставить раздел модули
**Модули** <<<------- здесь будет раздел, посвящённый отдельным модулям с краткой информацией и примерами по их использованию
[] <<<------- этот раздел не должен быть доступен через ссылки вперёд-назад, так как логически он не относится к обуч
[] <<<------- ающей информации. Это лишь дополнительная информация.
Список плагинов
Общие принципы для статей
Как можно читать справку
Удобочитаемость
Разбиение материала по статьям должно быть удобным и логичным.
Выделение новых ключевых слов, чтобы взгляд мог зацепиться.
Выделение ключевых моментов
Характерные примеры
1)
Похоже будет лучше объединить эти две статьи, не могу придумать, как будет хорошо в разделенном виде
2)
Список id, классов и кусочков body. Разные варианты для разных целей. Возможно ссылки на самоучители
3)
Список колбэков и переменных. Возможно ссылки на самоучители типа https://learn.javascript.ru/ . Возможно примеры кода для разных целей.
4)
я не возмусь писать, но статья нужная для тех, кто будет шаблоны править