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

Define a Syllabus enum for tutorial concepts #1199

Open
kostmo opened this issue Apr 4, 2023 · 2 comments
Open

Define a Syllabus enum for tutorial concepts #1199

kostmo opened this issue Apr 4, 2023 · 2 comments
Labels
C-Low Hanging Fruit Ideal issue for new contributors. S-Nice to have The bug fix or feature would be nice but doesn't currently have much negative impact. T-Tutorial Involves the tutorial experience for new players. Z-Feature A new feature to be added to the game.

Comments

@kostmo
Copy link
Member

kostmo commented Apr 4, 2023

In addition to coverage of specific swarm-lang commands (#1186), it may be useful to enumerate the more "abstract" concepts that are covered in each tutorial. This will help in generating a tutorials overview that can ensure sensible pedagogical progression. These enums can also be surfaced as labels in the tutorial selection UI.

Although some of tutorials themselves are named for concepts, there is not a simple 1:1 correspondence between concepts and discrete tutorial scenarios.

Some example members of this syllabus enum might be:

  • Sensing
  • Error handling
  • Recursion
  • Code reuse

More than one tutorial could "cover" each of these topics. Some tutorials might explicitly "teach" the concepts, while others assume th topics as prerequisites.

@kostmo kostmo added Z-Feature A new feature to be added to the game. T-Tutorial Involves the tutorial experience for new players. labels Apr 4, 2023
@byorgey
Copy link
Member

byorgey commented Apr 5, 2023

I like this idea. Other potential categories, off the top of my head:

  • Movement
    • This includes things like move and turn
  • Entity management
    • Includes things like make, grab/place/harvest, give, equip
  • Building robots
    • Includes things like build, require

@kostmo
Copy link
Member Author

kostmo commented Oct 2, 2023

#1546 is somewhat related in terms of categorizing commands by their nature.

@byorgey byorgey added S-Nice to have The bug fix or feature would be nice but doesn't currently have much negative impact. C-Low Hanging Fruit Ideal issue for new contributors. labels Aug 22, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C-Low Hanging Fruit Ideal issue for new contributors. S-Nice to have The bug fix or feature would be nice but doesn't currently have much negative impact. T-Tutorial Involves the tutorial experience for new players. Z-Feature A new feature to be added to the game.
Projects
None yet
Development

No branches or pull requests

2 participants