Документация QSP
Сайт Форум

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

=====To do=====

__**Это служебная страница, вас здесь не ждали =)**__

  * Доделать статьи в [[help:todo|help]].
    * Описание классика
    * Описание для остальных плееров
  * Сделать неймспэйс examples
    * Оставить совсем простые примеры в справке, а применимые конструкции вынести в этот раздел.
      * Двумерные массивы
      * Использование предмета на предмет
      * Стакающиеся (складывающиеся в стопку) предметы
      * Плейлист
      * Почти всё из "Как сделать?"
      * Удаление элемента массива с текстовым индексом.
    * Можно вынести туда примеры кода
      * Статьи удобнее просматривать, чем файлы.
      * Но файлы тоже должны быть
  * Сделать неймспэйс modules
    * Модули olegus'a:
      * https://forum.ifiction.ru/viewtopic.php?id=1613 - экран
      * https://forum.ifiction.ru/viewtopic.php?id=1522 - таблицы данных
      * https://forum.ifiction.ru/viewtopic.php?id=1527 - меню
      * https://forum.ifiction.ru/viewtopic.php?id=1540 - форматирование текста
      * https://forum.ifiction.ru/viewtopic.php?id=1873 - таймер
  * Самоучители - отдельный неймспейс для каждого или общий для всех?
    * регэкспы
  * Впихнуть куда-нибудь статью "Как писать игры" - в каком порядке удобнее обдумывать и писать, что изначально лучше локации прописать на листочке и т.п.

====Общие принципы для статей====

===Как можно читать справку===

  * **Последовательно** читать __ВСЕ__ статьи подряд, пропуская неинтересные.
    * __Ссылки сверху и снизу статей__
    * Возможно стоит реализовать другой вариант, но нет идей.
    * __Последовательное изложение__ информации
      * Т.е. минимальное количество отсылок "вперёд"
      * Если не ошибаюсь, то у меня это нарушается только с регэкспами, но так лучше.
      * Возможно __стоит перенести вывод на экран, предметы и действия до программирования__ в структуре
  * **Искать необходимое**
    * __Оглавление__
      * Удобная структура
      * //Ссылки на оглавление//
        * //В каждой статье//
        * //Или в меню слева//
      * Говорящие названия статей
    * __Список ключевых слов__ со ссылками на статьи
    * __Перекрёстные ссылки__ между статьями
    * __Словарь терминов__

===Удобочитаемость===
  * __Разбиение материала__ по статьям должно быть __удобным и логичным__.
    * Пока существует несколько актуальных плееров, приходится на это оглядываться.
      * Должно легко сводиться к одному плееру в будущем.
  * **Выделение** новых ключевых слов, чтобы взгляд мог зацепиться.
    * Реализовано **жирным**
  * Выделение __ключевых__ моментов
    * В каждой статье //индивидуально//
    * Но так, чтобы __не__ пестрило
  * __Характерные примеры__
    * Нужно будет многие переделать
      * Пока на это нет сил, времени и воображения

----

Благодарности:
  * Nex
  * Ajenta
  * MasterSet
  * olegus

Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Инструменты страницы

Документация QSP
Сайт Форум