Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Changelogs and Tags

Aperta
  • Qualcosa non va?
#197 1 commento 3 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
elixir, git, github
Ambito
documentation, release

Direzione di ricerca

Inizia da CHANGELOG.md e dai tag di release menzionati nella issue, quindi esamina come vengono pubblicate e rappresentate le versioni su GitHub. Il lavoro è completato quando release come 3.3.2 e 3.3.3 possono essere identificate e confrontate chiaramente, con informazioni di changelog aggiornate per gli utenti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Hello there 👋🏼

This is a general request related to the project's changelog, tags, releases, etc. — I'll explain it in narrative form and offer some suggestions of how the maintainers of the library could make my life easier as a consumer.

tl;dr A detailed and up-to-date changelog, and/or tags for all releases, would be very helpful! I understand that library maintenance is extremely time-consuming, but as a consumer, I'm unqualified to determine whether updating this package will break my application.

Today I noticed one of our application's dependencies is using a retired version, so it's time to do a round of updates. I usually do patch package updates at the same time for efficiency. This library has an available update:

# mix hex.outdated
libcluster              3.3.2       3.3.3       Update possible

That's a patch update, so chances are it won't break anything, but I always read the changelog to be sure!

Unfortunately, it doesn't have clearly-labeled information about the past three releases:

# Changelog

## Unreleased

- Use new cypher names
- Allow Epmd strategy to reconnect after connection failures
- Detect Self Signed Certificate Authority for Kubernetes Strategy
- Remove calls to deprecated `Logger.warn/2`

### 3.3.0

...

In this situation, I fall back to manually reading the changes because Elixir is (in my opinion) relatively easy to read. So we're interested in the changes between the 3.3.2 and 3.3.3 releases. The releases page is my usual way of doing this: (1) find the 3.3.3 tag and click on it, (2) use the Compare option in the left, and (3) choose the 3.3.2 tag. Thanks to GitHub auto-generating releases for all tags, this usually works even if the maintainer didn't create a formal release on GitHub with notes.

Unfortunately, the older release doesn't have a tag:

image

That's unfortunate, so we'll have to find the commit that represents the 3.3.2 release manually and use my knowledge of GitHub URLs to create a comparison between that commit and the latest tag. However, when we look at the commits, there's no indication of which one relates to the release:

image

Perhaps the 3.3.1 commit/tag is the same, and that's why this situation occurred. That would be fine, but unfortunately this is opaque to me as a consumer.

This incident isn't big enough to be worth posting about, but it has occurred a few times now. I can say with certainty that the maintainers of this library are by far smarter and harder-working than me. Unfortunately, it can be difficult to use the fruits of this labor because of release-related documentation. ❤️

Lingua principale
Elixir
Stelle
2.2k
Fork
202
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di bitwalker/libcluster

Tutte le issue di bitwalker/libcluster

Issue simili

Altre issue su Elixir

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.