Skip to content

Documentation references v2.X features but no v2.0+ release tags exist #1087

@AstralJaeger

Description

@AstralJaeger

Problem

The README and codebase reference features introduced in "v2.X" (specifically the multi-target /probe endpoint with YAML configuration), but there are no corresponding v2.0+ release tags in the repository.

This creates confusion about:

  1. Availability: Users cannot determine if these features are actually released or still in development
  2. Installation: Pre-built binaries link points to releases, but the latest release appears to be 1.9.0
  3. Version Planning: It's unclear whether v2.0 is upcoming or if the documentation is ahead of releases

Evidence

From the README:

### Multi-Target Scraping (beta)

From v2.X the exporter exposes `/probe` allowing one running instance to scrape many clusters.

Additionally, the config.file parameter documentation states:

| config.file | 2.0.0 | Path to a YAML configuration file...

However, checking the releases page shows the latest version is 1.9.0 from March 2025.

Impact

  • New users may be confused about whether they can use the multi-target features
  • Existing users don't know if they should wait for an official v2.0 release
  • Docker users pulling latest or master may get unexpected behavior if v2.0 features are in main but not released

Suggested Solutions

  1. If v2.0 is ready: Create a v2.0.0 release with appropriate release notes

  2. If v2.0 is still in development: Update documentation to clarify:

    • Mark multi-target features as "unreleased" or "available in main branch"
    • Update version references to say "upcoming in v2.0" or "available from main"
    • Add a note about building from source to use these features
  3. Alternative: If the versioning strategy has changed, update the README to reflect the current approach

Questions

  • What is the current status of the v2.0 release?
  • Should users build from main to access these features?
  • Is there a planned release timeline?

Thank you for maintaining this awesome project!

I'm willing to commit time to the project to help out with the V2 release, as these changes would benefit me aswell and I think the new multi-target mode is an awesome feature.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions