Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Expand builds-and-runs docs to clarify tag behavior across versions

オープン
#2,520 コメント 0 件 リアクション 0 件 担当者 1 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@TC-MO がすでに取り組んでいます。

2026年5月26日 から。

評価

この issue はまだ評価されていません。

説明

documentation t-docs

Reported on Slack: tag behavior on Actor builds is documented in fragments, with no single place explaining the full picture. Users hit confusing edge cases:

  • Two builds across different versions can share the same tag name (e.g., both 0.0 and 0.1 tagged latest). When the Actor runs, it picks whichever was built last.
  • The auto-tagging dialog reinforces the impression that tags are version-specific, when in practice the effective build for a tag is whichever was built and tagged most recently.

Current docs only state that tags are exclusive across all builds and versions, and that they move when another build is tagged the same.

They do not explain:

  • That tags can be set on builds via the Console UI and via the API (not only at build time).
  • How build numbers are constructed from MAJOR.MINOR by appending .BUILD.
  • That multiple versions can in theory share the same tag, that each new build overrides the tag, and that this is not practical, so different tags should be used for different versions.

Proposed changes

Expand https://docs.apify.com/platform/actors/development/builds-and-runs/builds#tags to:

  1. Document that tags can be set on existing builds through the Console UI and via the API, not only during build creation.
  2. In the Versioning section, explain build number construction (MAJOR.MINOR.BUILD).
  3. Add an explicit note that multiple versions can technically share the same tag, that each build overrides the tag, and that this is not a recommended pattern. Recommend distinct tags per version.
主要言語
JavaScript
スター
82
フォーク
240
平均マージ
4日 2時間
マージ済み PR(30日)
44

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

apify/apify-docs のほかの issue

apify/apify-docs の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。