tealdeer icon indicating copy to clipboard operation
tealdeer copied to clipboard

Add version support to published docs

Open Vye opened this issue 2 years ago • 3 comments

Hi,

Can versioning be added to the docs? I'm a new user and went through a fair amount of unnecessary steps to figure out custom page extension listed in docs is for an unreleased commit in main. :(

Extension changed: https://github.com/dbrgn/tealdeer/issues/320

No .md extension docs for 1.6.1 tag: https://github.com/dbrgn/tealdeer/blob/v1.6.1/docs/src/usage_custom_pages.md

With .md extension live docs with new extension: https://dbrgn.github.io/tealdeer/usage_custom_pages.html

Thanks for the client!

Vye avatar Mar 28 '24 19:03 Vye

That sounds like a good idea. If someone can come up with a not too complicated setup for this, it would be greatly appreciated :)

In the mean time, maybe we should only update github pages when we push a new release, not for every commit on main @dbrgn ?

niklasmohrin avatar Apr 09 '24 16:04 niklasmohrin

Yeah, it would probably make sense to have versioned docs. I don't know what would be required for that though.

dbrgn avatar Apr 09 '24 18:04 dbrgn

In the mean time, maybe we should only update github pages when we push a new release, not for every commit on main @dbrgn ?

That might be a good stop-gap solution until then.

dbrgn avatar Apr 09 '24 20:04 dbrgn