Создан  demius PM 4 года назад; Обновил  demius PM год и 4 месяца назад

Это обзорный документ по этой половине трекера, так как он менее стандартен.

Наиболее зависима документация от системы гипертекста Система гипертекста для wiki, позволяющую вставить в любое место трекера ссылку на любую страницу трекера, даже не существующую с тем, чтобы побудить её создание.

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

Типы будут реализованы в рамках tndt-45, как встроенный enum для документа. Для определения того, как складывать ссылки на документы в оглавления нужно добавить Категории, и ввести теги макросов, на месте которых будут списки документов…

Это обзорный документ по этой половине трекера, так как он менее стандартен.

Наиболее зависима документация от системы гипертекста Система гипертекста для wiki, позволяющую вставить в любое место трекера ссылку на любую страницу трекера, даже не существующую с тем, чтобы побудить её создание.

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

Типы будут реализованы в рамках tndt-45, как встроенный enum для документа. Для определения того, как складывать ссылки на документы в оглавления нужно добавить Категории, и ввести теги макросов, на месте которых будут списки документов входящих в категорию. (Вероятно для удобства нужно проставлять документу множество категорий, так и оглавлений будет много. Как вариант генерить оглавления по тегам, а категории оставить единым деревом для документов и задач, тогда категории будут делить систему работа по которой ведется в трекере, а теги делить документы на относящиеся к внутренней справке, внешней справке, генерящей хелпы, разным справкам для разных пользователей системы)

Категории будут разрабатываться в рамках tndt-44 скорее всего по второму пути, чтобы не было две разных одноименных сущности категория (категория проекта, общая для задач и документов и категория документа только для документа)

Комментарии могут оставлять только авторизованные пользователи
 demius год и 4 месяца назад

он, не то, чтобы устарел, но с частью выборов ,представленных здесь, мы определились. Плюс здесь почти ничего не описано из сделанного. например статус документа, только мысли на будущее.

 demius 3 года назад

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

Вторым этапом добавим тип оглавление и будем придумывать ему удобный и гибкий функционал.

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

 demius 3 года назад

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

  • А нужен ли тут тип, или такой документ пользователь пишет сам, а ссылки синеют как обычные вики-ссылки? Скорее всего да, например чтобы отрисовывать его не как обычный md со списком, а как свертывать пункты большой вложенности. Кроме того туда можно автоматически добавлять документы ,чтобы они не потерялись, например приписывая к юзерскому списку раздел не разобранное. Или позволив юзеру указать вместо части оглавления тег {category:<categoryName>}, чтобы воспользоваться имеющимся древом категорий.