Skip to content

Conversation

@UebelAndre
Copy link
Collaborator

@UebelAndre UebelAndre commented Mar 30, 2022

I don't think we need to update the pin for every release but 0.1.0 had some things missing from the release artifact so I think it'd be good to move to 0.2.0 where this is fixed.

Copy link
Member

@hlopko hlopko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't mind this PR, but to me as a reader 0.1.0 would clearly signal that I should look elsewhere for the up to date information (and that elsewhere would be GitHub releases). With 0.2.0 I'd be a little bit more confused (is it really just 0.2.0 or is this obsolete?).

We can consider updating docs on each release. Or even build and release docs with each release (that way we would have versioned docs).

Anyway, I don't feel strongly, hence approved :)

@UebelAndre
Copy link
Collaborator Author

I don't mind this PR, but to me as a reader 0.1.0 would clearly signal that I should look elsewhere for the up to date information (and that elsewhere would be GitHub releases). With 0.2.0 I'd be a little bit more confused (is it really just 0.2.0 or is this obsolete?).

We can consider updating docs on each release. Or even build and release docs with each release (that way we would have versioned docs).

Anyway, I don't feel strongly, hence approved :)

Thanks! Ideally I think there should be docs for each release and ones tracking main. This way we don't have to worry about the pins for older releases and the docs tracking main can have stronger guidance.

@UebelAndre UebelAndre merged commit 4d8de6e into bazelbuild:main Mar 31, 2022
@UebelAndre UebelAndre deleted the doc branch March 31, 2022 14:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants