JayMayer
commented
1 month ago I think this section will need a rewrite. Kamino is still used by some trainees, but the tool mentioned on the Set Up Planner page:
We are building a tool to automate this process
... is now built. Source code here:
The tool appears as the "Clone" button next to each issue on the curriculum site backlog pages.
My vote is to push use of the "Clone" button. Whilst Kamino does make the underlying action transparent ('I'm cloning an issue from this repository into my own repo/planner'), it's a pain to configure the keys with a group of trainees, and suffers from problems with default settings as above.
moneyinthesky
What is the hypothesis?
In Set Up Planner Section there are step-by-step instructions followed by the line:
This video seems to be more detailed than the text instruction and answers some questions I had when going step-by-step following the text instruction. But unfortunately I noticed this video link already after finishing setting up coursework-planner following text instructions.
Does it maybe make more sense to move the video link before the text instructions or, as an option, turn it into imbedded video so that it would be noticeable from the very beginning as a source of additional information to the text instructions.
Why is this important?
It may give provide some additional clarification to what to do and how to do it. For example, which settings to choose for Kamino Clone button:
or which options to choose while cloning the issue:
Additionally do we maybe want to ask trainees to check these settings options by default to prevent comments/mentions on original issues:
[x] Disable Kamino automatic comments on original issue [x] Prevent references to cloned issue on original issue (using this hacky method)