Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Housekeeping] Versioned docs #3783

Open
1 task done
RasmusKjeldgaard opened this issue Feb 7, 2025 · 0 comments
Open
1 task done

[Housekeeping] Versioned docs #3783

RasmusKjeldgaard opened this issue Feb 7, 2025 · 0 comments
Labels
housekeeping 👶🏻 New For new issues before prioritisation and refinement NOT Prioritized Issue not yet prioritized and added to a Milestone NOT Tech refined Needs Tech kickoff - solution outlined and agreed

Comments

@RasmusKjeldgaard
Copy link
Collaborator

Describe the housekeeping request

Teams will often be using slightly older versions of Kirby in their products, because their update cycle is, of course, different from our release cycle.

Because we currently only document the latest version on https://cookbook.kirby.design, developers get confused that sometimes the documented way of doing things is not working for them, because they are on an earlier version.

Nathan Curtis has some thoughts on why this makes sense too: https://medium.com/eightshapes-llc/versioning-design-systems-48cceb5ace4d

Have you considered any alternatives?

No, but we should consider if it is worth the effort.
But I do think this could be done faily easily, by publishing github page similar to our dev branches, but on the same trigger as we use for the publish script.

So when a new tag is added to the develop-branch, we automatically publish to github pages on https://cookbook.kirby.design/v1.2.3.

@RasmusKjeldgaard RasmusKjeldgaard added housekeeping NOT Prioritized Issue not yet prioritized and added to a Milestone NOT Tech refined Needs Tech kickoff - solution outlined and agreed 👶🏻 New For new issues before prioritisation and refinement labels Feb 7, 2025
@github-project-automation github-project-automation bot moved this to 💌 Inbox in Kirby Feb 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
housekeeping 👶🏻 New For new issues before prioritisation and refinement NOT Prioritized Issue not yet prioritized and added to a Milestone NOT Tech refined Needs Tech kickoff - solution outlined and agreed
Projects
Status: 💌 Inbox
Development

No branches or pull requests

1 participant