Skip to content

Commit d304115

Browse files
kevin27luedemannKevin Luedemann
and
Kevin Luedemann
authored
Add How to tag guide (#24)
* Add How to tag guide * Update How to Tag guide --------- Co-authored-by: Kevin Luedemann <[email protected]>
1 parent 24163f7 commit d304115

File tree

1 file changed

+71
-0
lines changed

1 file changed

+71
-0
lines changed

README.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,3 +70,74 @@ The newest version of freeplane (1.11.10) is needed.
7070
**There are no learning objectives or tests for an overview branch. The overview branch lets trainers pick and choose relevant topics within a branch to teach at any level required so it doesn’t need to complete the learning objectives that are strictly specified in the leaf sections.**
7171

7272
**In Overview, only the Header and Description are required.**
73+
74+
## How to TAG using the skill tree
75+
76+
Before showing examples, we are reiterating important rules and definitions of skills and the skill tree.
77+
All the rules can be found in the skill tree [Readme.md](https://github.com/HPC-certification-forum/skill-tree/blob/master/README.md).
78+
79+
### Skills
80+
81+
A skill is a learnable unit of content, which can be taught in no more then 4 hours and no less then 1 hours.
82+
It does not have a difficulty but can have requirements.
83+
84+
If content associated with a skill grows beyond approximately 4 hours, it out to be split into sub skills.
85+
The simple, original name remains and becomes an overview leaf in the skill tree.
86+
All sub skill get more descriptive names.
87+
Splitting has to be done in a way which ensures that an update of the certificate to the new sub skill is possible.
88+
89+
A skill overview contains the content of all the sub skills and can be used for linking as requirement.
90+
Linking it means, that only a broad understanding of the skill is required and not a specific set of skills.
91+
Using an overview of a skill for a course, means that only some of the content is relevant for a course and only an overview of a topic is given.
92+
93+
An overview cannot be examined an no credentials will be handed out, only actual skills do this.
94+
95+
### Skill tree
96+
97+
The skill tree contains the architecture of the skills.
98+
Architecture means division of skill and skill categories.
99+
100+
Requirements are not mapped in the tree.
101+
A network representation would be required for this to work properly.
102+
103+
### Skill Markdown files
104+
105+
Each skill and skill overview has a Markdown file containing information about the content as well as requirements.
106+
They are directly linked in the Mind Map.
107+
108+
### Changes to the skill tree
109+
110+
Adding new branches will require a discussion with the board, which meets regularly.
111+
Usually, only the leaves will change, meaning they will split into smaller and smaller leaves.
112+
An overview will be created and the certificated updated to the new sub skill.
113+
All requirements will now link to the overview unless changed by a skill curator.
114+
115+
### Example 1
116+
117+
The skill "Linux Bash" can be taught within two hours.
118+
It has no difficulty, but many beginner courses list this skill.
119+
120+
If this skill is split in the future, this becomes an overview.
121+
The content this skill had will be put into a sub skill and all certificates will be updated to the new skill.
122+
123+
### Example 2
124+
125+
The skill "Shell scripting" can be taught within four hours and has the requirement "Linux Bash".
126+
It is a larger topic and could be taught in beginner and advanced user courses.
127+
Using this skill as is will work if only basics are taught.
128+
If the content growth beyond four hours, the skill has to be split into sub skills (shown below)
129+
Calling them "shell scripting basic", "shell scripting advanced" is not accurate enough.
130+
131+
The advised procedure is to name the skill with regards to the specific content.
132+
A course about basic Linux usage would list these skills:
133+
* Linux Bash commands
134+
* Linux Bash, environment and variables
135+
* Shell scripting bash commands
136+
137+
A advance Linux course would list these requirements:
138+
* Linux Bash (the overview)
139+
* Shell scripting bash commands
140+
The course also lists these skills as content:
141+
* Linux Bash, sed, grep and awk
142+
* Shell scripting, branching
143+
* Shell scripting, loops and list iterations

0 commit comments

Comments
 (0)