search

HackYourFuture / study

Our gitbook study book for trainees
https://hackyourfuture.github.io/study/
21 stars 41 forks source link

Index is incorrect #16

Closed NidaulZafar closed 1 year ago

NidaulZafar commented 2 years ago

The material compiled in this study book is immensely valuable but it is extremely hard to navigate through the book using the navigation index present on the left side of the book. For example:

  1. If we click on the first link on the left top titled "Learning", the book opens and the sections start from learning and end on "Good ideas" present in the left side nav index. However, the sections in between namely "Learning From code", "how to ask questions" and others are not present there. Subsection titled "Good ideas" should move above the others if its a part of main section "learning" while others are not. This thing happens in the GIT section as well and other areas too.
  2. most of the time when we click on a link from the left index the page that opens starts from the middle of the page and I have to scroll it manually to the top to start reading from the top.
  3. In javascript week 1 we were required to read certain topics like "what is programming" what is java " variables" "values", and others. But it is quite confusing. when i click on the first topic what is javascript, the page that subsequently opens in the book is from the end of the javascript topic. all other topics like variables, functions etc are already gone above.
  4. in some sections the youtube videos are not in a sequence. For example in the operators topic, the teacher in the first video says earlier we have studied about what are operators and different types of operators. Today we are going to study....

Conclusion: No doubt the resource collection and the effort to make these and combining them is huge, but navigating through them is too confusing for beginners like me who are already intimidated by the complexity of javascript. I tried to fix some of the things but i was unable to do so using github because whenever I click "edit on github" only that specific page opens and there is no option of fixing the index etc

robvk commented 2 years ago

Thanks for the feedback, you are right that the navigation is not great. I will see what we can do about that.

The order of the topics in the curriculum of the HYF chapter (Amsterdam, Belgium, Denmark, etc) you follow should always be the way you read them. The way we made the study book is that any of the HYF coding schools can link to an explanation of certain topics so that we can share the material. But every country/city may have a slightly different order in which to approach it. Which is why the order on the left may not be the one that your coding school wants you to follow.

The same will be with the videos, some were once a series of videos made that has been cut up so that we can isolate topics to facilitate the different approaches. We also sometimes link to videos in a series from others that will have something similar. Let us know whenever something is unclear (or make a PR if you want) and we can see what we can do. Luckily, we have control over the operators ones so have swapped those around.

Hopefully that will make it a little easier to follow!