How to deal with documented features that are not released yet? #548
Labels
No Label
abra
abra-gandi
awaiting-feedback
backups
bug
build
ci/cd
community organising
contributing
coopcloud.tech
democracy
design
documentation
duplicate
enhancement
finance
funding
good first issue
help wanted
installer
kadabra
performance
proposal
question
recipes.coopcloud.tech
security
test
wontfix
No Milestone
No project
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: coop-cloud/organising#548
Loading…
Reference in New Issue
No description provided.
Delete Branch "%!s(<nil>)"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Background:
In #543 a user reported that a documented feature is not working. The problem was, that the feature is not released yet (needs an abra release). But the documentation change got merged already
Solution 1:
Don't merge documentation changes for new features directly. After a new abra release merge all documentation changes.
Pro:
Con:
Solution 1.1:
Merge all documentation changes for new features in a new branch (e.g.
abra-0.9.0
). After the release merge the branch into the main branchPro:
Con:
Solution 2:
When documenting a new feature also add the abra version it is/will be available in.
Pro:
Con:
Solution 3:
Every abra version gets its own documentation. There is a drop down menu on the docs site to specify the abra version.
Pro:
Con:
Discussion
If think we should tackle this problem but I'm not sure about the best solution. If you come up with another viable solution please also post it as a comment. Also please discuss the proposed solutions so we can agree on one :)
How to deal with documented featured that are not released yet?to How to deal with documented features that are not released yet?Nice. I think solution 2 is the best since anyone can run
abra -v
and know what is relevant.Agreed. Mkdocs-material seems to support a nice
md-version
thing for this (e.g. see https://squidfunk.github.io/mkdocs-material/setup/extensions/python-markdown/#admonition) but I can't work out how to turn it on 🤔Aight cool, let's do this in the future then! Starting with
7675df7d7c
.