Release Timeline — визуализация GitHub релизов в вашей документации

Данное приложение было создано для красивого и удобного показа изменений во Vue 3 проекте в его документации на VitePress. После оно было сделано универсальным, и может быть подключено в любой HTML странице как Web component или микрофронтенд.

Потестировать - https://vuesence.github.io/release-timeline/. Слева вверху можно указать любой публичный репозиторий.

Цель

В документации програмных проектов обычно есть changelog. Вести его вручную довольно неудобно, а показывать пользователю changelog или список коммитов из репозитория не очень user-friendly.

Например, на проекте vue-faq.org часто происходят изменение и добавление контента. Людям, которые уже были на сайте, нужен способ увидеть, что новое появилось за это время. Вручную описывать все изменения на отдельной странице - очень времязатратно.

Формат release-timeline с одной стороны визуально приятен и компактен, с другой - достаточно функционален.

Также можно отметить, что после задействования в документации проекта release-timeline, относишься к названию коммитов и pull requests намного ответственней. Также, как и к описанию релизов. Подбор названий релизов - повод для фантазии. В моем случае, фантазии ChatGPT с промптом: "generate 5 dragon names"

Как установить

Библиотека может быть использована во Vue 3 проекте, в VitePress (с поддержкой тем и стилей), как Web component или микрофронтенд на произвольном сайте. Подробней - в документации.

Библиотека без зависимостей, код - 5Кб в GZip при подключении во Vue 3 проект, и 60Кб (вместе с Vue 3 дистрибутивом) при подключении как Web component или микрофронтенд.


Telegram-канал о Vue и фронтенд-разработке: @vuefaq

@gmtd
13.02.2024 10:17 UTC
Первоисточник

Комментарии

@tavi
13.02.2024 07:19 UTC
0

Поробовал вести адрес своего проекта и нашел забавный баг: если в названии проекта есть подстрока 'view', она удаляется, и все обращения идут к проекту с измененным именем.
В моем проекте релизов нет, но можно использовать для теста - ввести https://github.com/taurus256/darkview и посмотреть, куда будут идти запросы (например, с кнопки "View on Github")

@gmtd
13.02.2024 07:40 UTC
0

Так надо с окончанием .git ставить строку, как в подсказке. Тогда все правильно распознает.

@novoselov
13.02.2024 11:03 UTC
0

Странно что не поддерживается markdown форматирование

Еще по какой-то причине проблемы с отрисовкой некоторых релизов

Как будто "серым" цветом, например v25 для

https://github.com/protocolbuffers/protobuf.git

@gmtd
13.02.2024 11:31 UTC
0

@novoselov

Странно что не поддерживается markdown форматирование

Потому что сейчас пакет занимает 6Кб, а с `markdown-it` размер увеличится в 10 раз
Если будет популярным, добавлю свой парсинг простых md строк. Сейчас обрабатываются только заголовки h1-h6

Еще по какой-то причине проблемы с отрисовкой некоторых релизов

Это типа "lazy-load" анимация неправильно отработала на больших списках при быстром скроле вниз, видимо. Изначально все затемненные, и при попадании на экран осветляются

@modelair
13.02.2024 15:18 UTC
0

подумал я сделать pr, но такая у вас анимация опасная)
оттестируйте на мониторах выше fullhd. но лучше ее переосмыслить и сделать адаптивной

@gmtd
13.02.2024 16:35 UTC
0

А что происходит?
Можно скриншот в ЛС или еще куда