Stream: platform development

Topic: releases, docs and examples


view this post on Zulip Luke Boswell (Jan 08 2025 at 10:24):

I know this is probably a bit of a nit... but while I'm looking at it in the basic-cli README I thought I might ask the question. Should the following be inverted; from this.

๐Ÿ‘€ examples:

- 0.18.0
- 0.17.0
- 0.16.0
- latest main branch

๐Ÿ“– documentation:

- 0.18.0
- 0.17.0

To more like this?

- 0.18.0: ๐Ÿ‘€ examples, ๐Ÿ“– documentation
- 0.17.0: ๐Ÿ‘€ examples, ๐Ÿ“– documentation
- 0.16.0: ๐Ÿ‘€ examples, ๐Ÿ“– documentation

My logic is that if you are looking for the 0.18.0 docs or examples then you would expect them together.

My other thought, was would it be better to link the versioned examples and documentation in the specific GH Releases; and only have the latest release e.g. 0.18.0 in the README?

view this post on Zulip Sam Mohr (Jan 08 2025 at 10:27):

That all looks good to me.

view this post on Zulip Sam Mohr (Jan 08 2025 at 10:28):

But you'll need to upload 0.16.0 if you want exactly this to work

view this post on Zulip Sam Mohr (Jan 08 2025 at 10:28):

I assume it's just an example

view this post on Zulip Luke Boswell (Jan 08 2025 at 10:31):

It's easy enough to add 0.16.0

view this post on Zulip Anton (Jan 08 2025 at 10:35):

only have the latest release e.g. 0.18.0 in the README?

It would make those links a lot harder to find for those unfamiliar with github releases

view this post on Zulip Anton (Jan 08 2025 at 10:36):

To more like this?

The repeated icons look a bit weird but having the two side-by-side is ok, not sure it really matters


Last updated: Jul 05 2025 at 12:14 UTC