Как стать автором
Обновить
  • по релевантности
  • по времени
  • по рейтингу

Перешли всем отделом геймдизайна на Notion. Полёт нормальный

Блог компании Lightmap Разработка игр *Управление проектами *Управление продуктом *Облачные сервисы

Недавно наш отдел геймдизайна поменял основной инструмент и переехал с Google Документов на Notion — хотели решить проблемы хранения и организации документов. В общем, ни разу не пожалели. 

Notion — это такой мегакомбайн, совмещающий в себе Jira, Confluence и Google Docs. В нем бок о бок уживаются огромная база данных, совместная работа над документами, календари, напоминания, списки задач, канбан-доски, интеграции сторонних инструментов и много-много другого.

Для себя мы организовали удобное хранилище всех геймдизайнерских материалов (ГДД, концепт-доки, фоллоу-апы, планы по контенту и так далее), сделали систему тегов, которая быстро позволяет найти любой документ, и создали готовые шаблоны для создания ТЗ в пару кликов.

Под катом расскажу, зачем решили сменить инструмент, как его выбирали и почему остановились на Notion. А мой коллега поделится логикой и организацией инструмента изнутри.

Читать далее
Всего голосов 50: ↑50 и ↓0 +50
Просмотры 13K
Комментарии 14

Mozilla пытается переложить на сообщество поддержку проекта MDN после массового увольнения сотрудников

Блог компании ITSumma Разработка веб-сайтов *Open source *Управление персоналом *Подготовка технической документации *

Разработчик популярного браузера Firefox, компания Mozilla, пытается переложить на сообщество поддержку проекта Mozilla Developer Network (MDN) — единой площадки публикации документации для веб-разработчиков. Для этих целей компания Mozilla учредила организацию Open Web Docs.

MDN описывает типы поддерживаемых в современных браузерах технологий, включая JavaScript, CSS, HTML и различные Web API. Проект оказался на грани закрытия по вине самой Mozilla.

Читать далее
Всего голосов 29: ↑27 и ↓2 +25
Просмотры 7.6K
Комментарии 17

РБК: Производители электроники испытывают проблемы с документами для ФСБ и вынуждены получать нотификации в Казахстане

Законодательство в IT IT-компании

Некоторые крупные производители смартфонов для российского рынка начали получать документы-разрешения для властей в Казахстане из-за проблем с их получением в России, сообщает РБК. Речь идёт о нотификациях, которые нужны при импорте товаров, в которых содержатся элементы шифрования и криптографии — смартфонов, планшетов, ноутбуков, серверов и другой техники.

Читать далее
Всего голосов 14: ↑12 и ↓2 +10
Просмотры 2.9K
Комментарии 0

Бизнес увидел риски в законопроекте об электронных дубликатах документов

Хранение данных *Законодательство в IT

Поправки к внесенному в Госдуму законопроекту «Об информации, информационных технологиях и о защите информации», которые касаются хранения документов, не выполняют первоначальные цели и нуждаются в корректировке, считают представители бизнеса. Они отмечают, что исполнения закона в его текущем виде не приведет к сокращению расходов на обслуживание и создаст барьеры для кредитных организаций.

Читать далее
Всего голосов 7: ↑7 и ↓0 +7
Просмотры 844
Комментарии 0

NPJ — эффективное средство для ведения проектов и документации

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

Читать дальше →
Всего голосов 16: ↑14 и ↓2 +12
Просмотры 6.3K
Комментарии 27

Техническая документация: сервера и сети.

Системное администрирование *
Приходя на новое место работы, каждому системному администратору хочется получить пакет исчерпывающей технической документации. И первые по важности в этом пакете документы об устройстве сети и серверов.
Читать дальше →
Всего голосов 38: ↑33 и ↓5 +28
Просмотры 55K
Комментарии 13

Документация – экономия времени или его бесполезная трата?

Системное администрирование *
Искусство организации рабочего времени (time-management) последнее время обретает всё большую популярность и если раньше это в основном относилось к менеджерам различного уровня, то теперь накопленные знания начинают применяться и в других областях деятельности компании.
Читать дальше →
Всего голосов 22: ↑17 и ↓5 +12
Просмотры 23K
Комментарии 18

Использование asciidoc для документирования проекта

Управление проектами *
Когда перед нашей фрилансерской группой встала задача документирования проекта, были сформулированы следущие требования:
  • Как известно, программисты, обычно, не очень любят писать документацию… поэтому чем проще и комфортнее будет её писать, тем больше вероятность, что её таки будут писать.
    • Поскольку мы работаем из дома, то должна быть возможность писать документацию локально, на своей машине.
    • Чтобы это было делать комфортно, нужна возможность использовать для этого любимый текстовый редактор, никаких форм на вебсайтах а-ля вики или систем заточенных под конкретный редактор/IDE.
    • С доступом в инет у всех по-разному, и чтобы исключить ситуацию, когда документация небыла написана исключительно потому, что когда появилось настроение её писать по закону подлости отвалился инет — для написания документации не должен требоваться инет.
  • Документация должна быть доступна всем, кто работает над проектом. Это включает как возможность читать её через вебсайт так и работать с ней как с обычными локальными файлами.
  • Желательно, чтобы документация поддерживала какой-нить язык разметки и гиперссылки, чтобы её было удобно читать.
  • Возможность редактировать документацию из браузера (а-ля вики) желательна, но не очень важна (разработчики будут работать с файлами, так что эта фича может пригодиться в основном клиенту, который врядли будет напрямую править документацию).

Читать дальше →
Всего голосов 29: ↑27 и ↓2 +25
Просмотры 20K
Комментарии 22

Забытая фаза проектирования

Чулан
Сейчас почти в каждой статье про web 2.0 и стартапы среди рекомендаций можно увидеть совет: бросьте долгие раздумья и пред-проектную документацию — делайте проект! И очень часто этот совет воспринимается буквально, первые строчки кода появляются еще до того, как идея окончательно сформируется. Что в итоге? А в итоге ядро системы за весь период разработки переписывается раз по 15, не говоря уже о фронтенде. Как следствие проект который был задуман как 1-2х месячный растягивается на пол-года — год. А код превращается в сборище багов.

Что же сделать что-бы этого избежать и при этом не заниматься планированием по пол-года?
Читать дальше →
Всего голосов 23: ↑19 и ↓4 +15
Просмотры 895
Комментарии 57

Основы программирования под Битрикс

CMS *
Основы программирования под Битрикс

В статье Как создать раздел сайта под управлением «1С Битрикс: Управление сайтом». Основы программирования под Битрикс даётся краткий обзор шагов, необходимых для создания раздела сайта под управлением «1С-Битрикс: Управление сайтом 6.5». Статья может служить отправной точкой для начала изучения принципов программирования под Битрикс. В тексте статьи содержатся ссылки на соответствующие разделы документации и страницы официальных учебных курсов с более детальной информацией.

Дабы избежать нападок в стиле «статья заказная», «автор не разбирается», сразу предупрежу, что статья написана на основе личного опыта авторов по освоению Битрикс-программирования и является конспектом внутреннего семинара компании. Также при создании статьи очень помогли посетители форума офсайта Битрикса, указавшие на неточности.

Читать дальше →
Всего голосов 21: ↑9 и ↓12 -3
Просмотры 32K
Комментарии 15

Документация о вашем предприятии

Чулан
Обед был омрачен необходимостью разъяснять новому какому-то начальнику-князьку смысл и принципы деятельности некоторых отделов. Высшее начальство, как водится, ни черта не знает о реальных делах своих подчиненных — но хотя бы пожелало разобраться в этот раз. Неприятность состояла в том, что я принципиально за обедом о работе забываю, а тут — надо.
Читать дальше →
Всего голосов 5: ↑5 и ↓0 +5
Просмотры 370
Комментарии 6

JavaScript. Создание объектов

JavaScript *
JavaScript предоставляет разработчикам возможность создавать объекты и работать с ними. Для этого существуют следующие приёмы:
  • Оператор new
  • Литеральная нотация
  • Конструкторы объектов
  • Ассоциативные массивы

Читать дальше →
Всего голосов 56: ↑42 и ↓14 +28
Просмотры 102K
Комментарии 81

Проект Samba получил спецификации по протоколам от Microsoft

Настройка Linux *
Проект Samba получил спецификации по сетевым протоколам, используемым в серверных вариантах Windows.

Это стало возможным в результате решения Еврокомисии о предоставлении спецификаций протоколов конкурентам. Решение было принято еще в марте 2004, но МС подало аппеляцию, которую суд отклонил в сентябре этого года.

Джереми Аллисон, один из разработчиков Samba, сказал, что соглашение устанавливет точное колечество используемых патентов, так что здесь не может быть двоякого толкования текста в будущем.

Проект Samba: http://www.samba.org/
Пресс-релиз на английском языке: http://samba.org/samba/PFIF/
История судебного процесса: http://samba.org/samba/PFIF/PFIF_history.html
Текст соглашения: http://samba.org/samba/PFIF/PFIF_agreement.pdf
Всего голосов 33: ↑31 и ↓2 +29
Просмотры 674
Комментарии 41

ТЗ: макеты или текст?

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

Никак не комментируя заметку в целом, хотелось бы сделать несколько замечаний по поводу разных способов представления информации в ТЗ и не только в нём.

Читать дальше →
Всего голосов 2: ↑3.5 и ↓-1.5 +5
Просмотры 8.8K
Комментарии 24

Техническое задание — To be or not to be?

Управление проектами *Подготовка технической документации *
Прочитал статью Станислава Малкина — Для заказчиков: если нет ТЗ.

Вообщем-то написано всё грамотно, последовательно и понятно.
Сделан напрашивающийся вывод — техническому заданию быть — to be! (Однозначно! Я сказал! Жириновский)

И быть ему, по мнению Станислава, следует по трем вариантам:
  1. ТЗ написано самим заказчиком.
  2. ТЗ написано разработчиком заказанной системы.
  3. ТЗ написано профессиональным составителем ТЗ.


Я думаю что первый вариант имеет право на жизнь только если у заказчика уже имеется опыт написания ТЗ, основанный на втором и/или третьем варианте.
Пока пропустим второй вариант и обратимся сразу к третьему. Насколько можно судить по статье — Станислав считает этот вариант самым приемлимым, особенно для начинающих заказчиков. Однако я вижу гораздо больше минусов чем указано в статье (собственно единственный указанный минус — дополнительные расходы на написание технического задания):

Читать дальше →
Всего голосов 1: ↑1 и ↓0 +1
Просмотры 8K
Комментарии 64

Мой знакомый разработчик

Разработка веб-сайтов *
Я работаю с удивительным человеком. Каждый раз, когда я смотрю в bugzill'у или проверяю почту, я им поражаюсь. Иногда мне кажется, что он мог бы стать неплохим писателем. Во всяком случае графоман из него отличный.

Этот разработчик принимает документирование очень близко к сердцу.
Что же тут такого удивительного?
Всего голосов 64: ↑59 и ↓5 +54
Просмотры 619
Комментарии 38

BullDoc — система разработки документации

Я пиарюсь

Давайте знакомиться


Каждая разработка, если она хоть немного поэтичней, чем печать «hello world», требует документации. И как-то так получалось, что я начинал писать документацию и все время наталкивался на то, что мне это неудобно:


Документация в MS Word (Open Office) не имеет подсветки кода, держит все в одном длинном документе, его не положишь в систему контроля версий для отслеживания изменений. Такой документ невозможно без лишних трудностей сохранить в html-коде, который будет размещён на сайте.


Microsoft HTML Help Compiler позволяет все хранить в тексте, но не имеет подсветки синтаксиса, документ нельзя собрать в связанные html-страницы для выкладывания на сайт без active-x компонента

Формат Docbook тоже близок к желаемому, но XSLT трансформации сложны, подсветка синтаксиса — хоть и решаемая, но проблема.

PHPDocumentator нацелен на написание документации в виде комментариев к коду. Да, он поддерживает подключение нескольких страниц чистой документации к тому, что получилось (кажется это называется там термином тюториал). BullDoc направлен на написание документации в чистом виде — в виде книжки. Опрятной нормальной книжки с главами, разделами, оглавлением и индексом. То, что получается на выходе из PHPDoc это рабочий инструмент, никак не документация для конечного юзера.

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

Читать дальше →
Всего голосов 41: ↑35 и ↓6 +29
Просмотры 1.6K
Комментарии 50

документация android оффлайн

Чулан
Если для кого то будет полезным, выкачал Teleport'ом документацию по андроиду.
рапида
p.s. не говорю, что там все красиво, css немного дал о себе знать в меню, а во всем остальном нормально.
Всего голосов 7: ↑6 и ↓1 +5
Просмотры 312
Комментарии 6

Предпроектная документация: что это и почему она так важна?

Управление проектами *
Среди моих знакомых нет ни одного, кто любил бы писать технические задания или что-то вроде этого. Чертить на салфетках планы захвата вселенной, собирать лэйауты из разноцветных стикеров, шлифовать концепцию в голове и на словах – это все любят и умеют делать, а вот сесть и как следует записать…
Меня, например, любой шаблон серьезного документа погружает в глубочайшую тупку.

У моих знакомых очень много хороших идей, но с таким подходом, слава богу, что дело редко доходит до производства. Почему? Плохо продуманные проекты редко бывают успешными. Либо команда по уши вязнет в тех работах, которые не были видны в начале, либо получается кривоватый, плохо приспособленный к жизни гоблин. Плохо масштабируемый к тому же.

Читать дальше →
Всего голосов 55: ↑50 и ↓5 +45
Просмотры 9.1K
Комментарии 52