Идеология

Хотя есть, наверное, сотни разных подходов к форматированию Вики: традиционные вики-системы, корпоративные вики - мы сфокусировались на использовании наиболее распространенного формата MediaWiki, который, в частности, используется на Википедии.

Знание синтаксиса Вики - это хороший плюс при использовании Comindwork, так как в системе не везде показывается визуальный редактор. Например, нет для него места в комментариях к блогу или к документу. Но иногда ведь нужно вставить картинку или ссылку, или просто улучшить внешний вид текста.

Приведем другой пример полезности режима редактирования вики-разметки. Допустим, понадобилось создать список, состоящий из множества почти одинаковых ссылок. В визуальном редакторе придется вставлять каждую ссылку по отдельности через диалоговое окно. Вместо этого можно переключить редактор в режим вики-разметки, скопировать код ссылки, который послужит шаблоном, в буфер обмена, вставить этот код нужное количество раз, а затем во вставленное внести необходимые мелкие исправления.

Общие правила

1. MediaWiki - http://meta.wikimedia.org/wiki/Help:Editing
   1. В отличие от MediaWiki вы в Comindwork можете также использовать HTML, нет никаких ограничений.
   2. В MediaWiki абзацы отделяются "двойным переносом строк", в Comindwork абзац создается по единичному переносу

Основные стили

Строчные стили Название Пример Код Жирный bold '''bold''' Наклонный italic ''italic'' Подчеркивание underlined __underlined__ Помните, что вы можете вводить HTML-тэги, например 'sub или 'strike'

Заголовки Название Пример Код Заголовок 1 Head 1 = Head 1 = Заголовок 2 Head 2 == Head 2 == Заголовок 3 Head 3 === Head 3 === Заголовок 4 Head 4 ==== Head 4 ==== Заголовок 5 Head 5 ===== Head 5 =====

Форматирование абзацев: списки и отступы

Название	Пример	Код
Цитата	TEXT	<blockquote>TEXT</blockquote>
Отступ	ident	начните строку с символа(ов) ":"
Нумерованный список	Number1 Number1	# Number 1 ## Number 1
Ненумерованный список	Number1 Number2	* Number 1 ** Number 2

Ссылки

Название	Пример	Код
Документ в проекте	COMINDWORK/Help	[[COMINDWORK/Help]]
Документ в проекте, с измененным текстом ссылки	Специальное Имя	[[COMINDWORK/Help|Специальное Имя]]
Ссылка на документ без указания проекта	Help	[[!COMINDWORK/Help]]
Задачи	COMINDWORK/CASE1	[[ProjectAlias/CASE1]]
Внешние страницы	http://www.comindwork.com	[http://www.comindwork.com]
Внешние страницы, с измененным текстом ссылки	Comindwork	[http://www.comindwork.com Comindwork]
Файлы	COMINDWORK/FILE/Help.pdf	[[COMINDWORK/FILE/Help.pdf]]

Красный цвет ссылок означает, что ссылка ведет на несуществующую страницу, файл, задачу и т.д.

Вставки и специфичные возможности

Вставка картинок

Чтобы вставить картинку в текст,

• залейте ее в файловое хранилище
• используйте {{\\Path\To\YourImage.jpg}} (заметьте два символа \ перед началом пути). Пример:

• Подсказка: если вы добавили файл с пробелами в имени, пожалуйста, в ссылке на него замените пробел на %20

Вставка страниц

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

Чтобы вставить другую страницу или документ:

• используйте {{PROJECT/PAGENAME}}
• Подсказка: Чтобы спрятать часть страницы при вставке, используйте тэг

Выключение Wiki-форматирования

Вы можете захотеть выключить форматирование Вики для какой-либо части текста. Вы можете это сделать таким вот образом:

Ideology

Although there are tons of different wiki formatting approaches (traditional wikis, various enterprise systems etc) - we focused on use the most widespread formatting provided by MediaWiki and adopted by the most popular wiki-based resource WikiPedia.

Knowing Wiki syntax is a good plus, as we don't show rich editor at any wiki text box, like blog comments or wiki page comments. But sometimes you may want to enter a link in comment or enhance your formatting.

General rules

1. MediaWiki - http://meta.wikimedia.org/wiki/Help:Editing
   1. Unlike MediaWiki you can use HTML as well in Comindwork Wiki, no limitations are applied.
   2. MediaWiki has paragraphs created by "double enter", Comindwork also creates BR-tag for "single enter"

Main Styles

Inline styles Name Sample Code Bold bold '''bold''' Italic italic ''italic'' Underlined underlined __underlined__ Remember you may enter pure HTML tags, like 'span' or 'strike'

Headings 1-5 Name Sample Code Heading 1 Head 1 = Head 1 = Heading 2 Head 2 == Head 2 == Heading 3 Head 3 === Head 3 === Heading 4 Head 4 ==== Head 4 ==== Heading 5 Head 5 ===== Head 5 =====

Paragraph-formatting: Lists and Indent

Name	Sample	Code
Identation	:ident	start new lines with ":" sign
Numbered list	Number1 Number1	# Number 1 ## Number 1
Unnumbered list	Number1 Number2	* Number 1 ** Number 2

Links

Name	Sample	Code
Project Page	COMINDWORK/Help	[[COMINDWORK/Help]]
Project Page with custom title	Custom Title	[[COMINDWORK/Help|Custom Title]]
Project page without project name	Help	[[!COMINDWORK/Help]]
Cases	COMINDWORK/CASE1	[[ProjectAlias/CASE#]]
External pages	http://www.comindwork.com	[http://www.comindwork.com]
External pages with custom title	CoMindWork	[http://www.comindwork.com CoMindWork]
Files on filesystem	NI/COMINDWORK/Help.pdf	[[/NI/COMINDWORK/Help.pdf]]

Please note that red color means link to not-existing page or case.

Includes and special issues

Including images

To insert an image on a page,

• upload it to filesystem
• use {{\\Path\To\YourImage.jpg}} (Note the 2 slashes before actual location)
• TIP: if you've uploaded file with spaces in name, please refer to it, replacing spaces with %20

Including pages

Including pages is a powerful mechanism for creating TOC-pages or navigation snippets to other pages. For example, when structuring project requirements, you may want to put navigation to to the top of every requirements-related page.

To insert an page:

• use {{PROJECT/PAGENAME}}
• TIP: If you're referring to a page that starts with user/default/ you may use {{:PAGENAME}}
• TIP: To hide a part of the page when including, use

Switching off Wiki formatting

You may need to switch off Wiki formatting for some block of text. You can do it using the following syntax:

Useful templates

Name	Sample	Code
Quote	TEXT	<blockquote> TEXT <blockquote>
Red	TEXT	{{:Red| TEXT }}
Green	TEXT	{{:Green| TEXT }}
Pretty table	This table is generated using <table {{:PrettyTable}}>

Обычные инструменты поддержки работы (в виде любых workflow-систем, включая BPM, системы управления бизнес-процессами) дают не так много для работников умственного труда. Это происходит потому, что эти системы построены на одном и том же принципе планирования. Сначала определи задачи, раздай их, потом собери воедино результаты. То есть, сначала одна задача, потом другая, одним потоком. Иногда, к счастью работников, больше чем один поток активностей может происходить в одно время. Но обычно инструменты и обучение менеджеров диктуют нам условия: как нам делать задачи, и в каком порядке.
 
Этот подход работает только для типов задач, которые повторяются и могут быть наполовину автоматизированы. Работая в которых, люди не допускаются до низкоуровневого принятия решений. Например,

• Проверки на соответствие качеству
• Строительство
• Выпуск новых версий продукта
• Сборочные линии
• Логистика
• Бухгалтерия и счета
• Торговля ценными бумагами

Но умственная работа, точнее, ум и внимание, работает совсем по-другому. Часть задач не могут быть определены заранее и повторены механически. Скорее, каждый рабочий процесс зависим от других людей, и является процессом переговоров с коллегами. Информация должна быть собрана и проверена разнообразными способами, действия должны быть чувствительны к бизнес-окружению. В этих областях, планы зачастую постоянно меняются по ходу работ. Обычные области умственного труда, которые невозможно поддерживать с помощью инструментов
"производственного процесса", это, например:

• Исследования
• Разработка продукта/услуги
• Маркетинг
• Продажи сложных продуктов
• Поддержка пользовател
• Работа с партнерами
• Управление организационными изменениями
• Управление командами
• Аудит
• Внедрение стратегии/политики
• Переговоры

"Процессы, основанные на задачах, которые описывают как сделать ту или иную задачу. Эти процессы в основном регламентируются ИТ-системами и управляют "ресурсами". В то время как процессы, основанные на людях, определяют или описывают, как люди работают вместе. Обе части важны для бизнеса. Однако, они совершенно разные, и не могут одинаково хорошо поддерживаться одним набором политик и технологий"

Чтобы проиллюстрировать недостатки ПО, которое базируется исключительно на определении задач, вспомните о странной, но повсеместной трагедии современного "рабочего места". Людей нанимают за их умственные качества (способность к аналитике, стратегическое мышление, креативность и т.д.) и потом их за это штрафуют.
 
Когда рабочие процессы будут поставлены на место, которое действительно отражает, что люди хотят сделать и достичь, менеджеры смогут заняться своей настоящей работой: поддерживать начинания сотрудников, улучшая условия их работы.
 
Организации должны научиться использовать время и умственные усилия своих сотрудников в исследованиях, сравнении, оценке своих сил, принятии решений, и вцелом превращении информации в идеи и знания.
 
Источник: Keith Harrison-Broninski - Human Processes