Courier Service Account

Назначение

Регламент по созданию/редактированию статей предназначен для сотрудников "MeaSoft", которые работают с контентом на сайте wiki.courierexe.ru.

Подготовка

1. Необходимо изучить статьи Википедии по алгоритму работы с информацией. Начать можно с прочтения Создание статьи, Оформление статей. Необходимую информацию по шаблонам, так же, можно найти на Википедии.
2. Статья-пример, которая демонстрирует структурные правила и особенности наполнения - Мобильное приложение курьера для IPhone.
3. Не будет лишним посмотреть обычные статьи Википедии, чтобы понять основной принцип – единообразие структуры, наполнения и оформления.

Иерархия

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

Структура

1. Прежде чем приступать к написанию/корректировке статьи, необходимо узнать логическую цепочку процесса и причинно-следственные связи в программе.
2. Заголовки в статьях не должны быть более 3 слов, не считая предлоги и знаки препинания.
3. Если создается новая статья, то оптимальным будет - создание «Скелета» (набор заголовков, которые покажут общую картину и помогут последовательно или одновременно наполнять разделы статьи контентом). Зачастую, пользователю достаточно посмотреть на заголовки статьи, чтобы найти интересующую его информацию, даже если наполнения раздела еще нет.
4. Обратите внимание, заголовок должен четко отражать сущность написанного в блоке, быть логичным и корректно сформулированным. Пример: заголовок- «Выбор картографической системы», изначально был – «Взаимодействие модуля «Карты» с картографическими системами» сама статья.
5. Важно учитывать логические связи между заголовками и подзагаловками. Для этого необходимо выстраивать связи – от общего к частному. Желательно, соблюдать логику действия пользователя, чтобы помочь пройти путь от начала до конца.

Наполнение

1. После заголовка необходимо описать что это, затем необходимо рассказать о задачах, которые решает функционал, если из их описания это не понятно, а затем об опыте использования или о полезных "фишках".
2. Наполнение должно быть актуальным и отражать реальное положение дел, на данный момент. Если есть информация, в которой нет уверенности или требуется разъяснение, то лучше уточнить.
3. Если же актуальной информации нет, то можно оставить раздел пустым, до момента появления информации (можно оставить запись, что раздел на этапе написания).
4. Большую часть информации можно найти в старых статьях или у сотрудников "MeaSoft". Так же, можно исследовать программное обеспечение самостоятельно.
5. Обратите внимание, что текст будет прочитан обычными людьми, не обладающими профессиональными навыками в программировании или других прикладных дисциплинах, поэтому следует использовать максимально понятный вид изложения.
6. Не нужно каждый раз делать ссылку на информацию относительно элементов интерфейса (например: основное меню, вкладки, таблицы и подобное). Данное ограничение не касается статей и разделов статей, которые помогают лучше понять работу той или иной функции программы.
7. Если в тексте содержатся слова, требующие детального описания, то необходимо добавить их в раздел «Терминология» и сделать ссылку в основной статье. Так же, можно давать внешние ссылки на Википедию, в случае, когда описание подходит под задачи и не требует уточнения.
8. В случае, если раздел статьи получается слишком объемным, то можно его разбить на подразделы, если получается много подразделов, то имеет смысл создать отдельную статью.
9. Чтобы не описывать информацию, данную ранее или описанную в других статьях – просто укажите на данную информацию Ссылку. Статья о ссылках.
10. Статья должна состоять из фактов, поэтому не стоит использовать собственные ассоциации и сравнения. Обратите внимание и на изложение, т.к. повествование должно быть беспристрастным, чтобы показать объективную реальность.
11. Если требуется показать пользователю расположение переменной или функции в программе, то следует использовать оформление следующего вида: "Справочники" -> "Переменные" -> "Сотрудники" -> "Статус курьера по умолчанию:".
12. Информацию по полям в программе необходимо оформлять следующим образом:
    1. Не все поля в программе следует заполнять, поэтому изначальная формулировка, используемая для перехода к информации должна быть нейтральной. К примеру: "Рассмотрим карточку" или "В карточке присутствуют следующие поля" и т.д..
    2. Название каждого поля должно быть оформлено с использованием жирного курсива, для удобства поиска и прочтения информации.
    3. Пояснение функции каждого поля не должно быть большим. Если объем получается значительным, то имеет смысл рассмотреть функцию отдельно.
    4. Пояснение функции не должно дублировать информацию из других пояснений функций.
    5. Пример оформления полей
13. Если же в разделе статьи есть информация технического характера или же информация, которая может пригодиться в ограниченном количестве ситуаций, то ее можно спрятать под Спойлер

Шаблон для использования спойлера

Объем статьи/раздела

1. Основной принцип, которым должен руководствоваться автор - удобство чтения пользователя.
2. Рядовой читатель устает от прочтения 6-10 тысяч слов, что ровняется 40-50 тысячам знаков видимого текста. Если основная статья значительно больше данных значений, то имеет смысл вынести часть информации в отдельную статью.
3. Если же статья является началом большой темы и выступает "фундаментом" для дальнейших статей, то ее размер может быть и больше 10 тысяч слов.
4. Обратите внимание, что статьи с трудночитаемой (научной) информацией должны быть значительно меньше статей с общими понятиями.
5. Как текст не учитываются: вставки и разделы "Содержание", таблицы, изображения, галереи и подписи к ним, справочные разделы ("Примечания", "См. также", "Ссылки", "Литература" и аналогичные им, категории и служебные отметки (дата последнего изменения, лицензия и т. п.).
6. Если нужно вынести из статьи раздел, который содержит большое количество информации, то следует вкратце описать информацию и сделать ссылку на новую статью. Так же допустимо оставить просто ссылку на новую статью, без краткого содержания, если из названия понятно содержание.
7. Для выделения раздела в отдельную статью должны учитываться следующие критерии: достаточный размер раздела (не стоит создавать статью ради 500-1000 знаков), единство содержания (раздел должен в полной мере освещать одну тему), не должно быть разночтений, не должно быть сложностей с формулировкой названия, статья должна обладать самостоятельной значимостью. Если один из критериев не учитывается, то выделять раздел в отдельную статью не стоит.
8. В статье, создаваемой из раздела должно быть написано введение, кратко описывающее информацию из "родительской статьи" и отсылающее к ней.

Общие рекомендации:

Видимый (чистый) текст	Что делать
> 100 000 знаков	Если статья не подпадает под исключения, её следует разделить на две или более подстатей.
> 50 000 знаков	Вероятно, статью следует разделить (с другой стороны, иногда для более полного раскрытия темы может быть оправдано создание статьи большого объёма).
> 30 000 знаков	На данном этапе вопрос о разделении статьи пока не стоит, однако возможно, что это придётся сделать в будущем.
от 1000 до 30 000 знаков	Не требуется принятия каких-либо действий по изменению объёма статьи.
< 1000 знаков	Если объём статьи не меняется на протяжении месяцев, следует задуматься о возможности её объединения с наиболее близкой по теме статьёй, сделав из неё перенаправление. Кроме того, почему бы просто не постараться добавить в неё информацию?
< 150—300 знаков	Статьи менее 150—300 знаков обычно должны удаляться.

Работа с изображениями

У каждого формата изображения свои предназначения, поэтому, прежде чем выбрать какой-либо формат, будь то .jpeg, .png, .gif, .bmp, прочтите общую информацию об этих форматах. Для простых изображений (с небольшим количеством деталей) лучше подходит .png, т.к. занимает меньше места. Так же стоит учитывать, что одно изображение может решать несколько информационных задач, поэтому подбирать нужно максимально информативное изображение, взглянув на которое пользователь смог бы понять логику из текста. Немало важным является аккуратность в создании изображения, не стоит загружать некачественно обработанные файлы или не несущие никакой информации.

1. Прежде чем загружать изображение на сервер убедитесь, что нужного файла на нем нет. Можно поискать файл по названию (название может отражать назначение изображения), так же, можно поискать статьи, в которых могло бы использоваться нужное изображение. Если вы обнаружили, что изображения нет, тогда подберите или создайте его, далее необходимо загрузить файл на сервер, а затем разместить в статье .
2. Прежде чем выгружать изображение на сервер проверьте его содержимое, а именно: есть ли на изображении личные данные людей (если скриншот сделан в программе, то имейте в виду, что в тестовой версии есть реальные данные людей, размещение этих данных без их согласия является нарушением закона), реальные фотографии людей, данные существующих организаций и др.
3. В Википедии есть статья посвященная изображениям.

Употребление слов в контексте

• Кнопка - нажать на кнопку, кликнуть на кнопку. Если описывается работа с сенсорным экраном, то позволительно использовать "тапнуть" (прикоснуться пальцем).
• Контекстное меню - вызвать контекстное меню, выбрать пункт контекстного меню, использовать контекстное меню, воспользоваться и т.д.
• Маркер - назначить маркер, перетащить маркер, настроить маркер, перенести маркер, снять назначение, переназначить.
• Доступ - предоставить доступ, запретить доступ, разрешить доступ, ограничить доступ.
• Фильтр - использовать фильтр, настроить фильтр, изменить.
• Настройка - применяется, выбирается, регулирует, назначает, изменяет.
• Галка - ставится.
• Пункт меню - выбирается.
• Окно - открывается, всплывает, изменяется, масштабируется.
• Интеграция - используется, отрабатывает, настраивается, работает.
• Активировать - параметр, условие, переменную, функцию.