add files (#276)

Co-authored-by: Christopher Knapp <83461866+chrisknapp98@users.noreply.github.com>

content/ss23/master/m3-intu/_index.md

@@ -1,12 +1,10 @@
 +++
 title = "Intu"
 project_id = "M3"
-sub_title = "interactive tutorials with intuitive knowledge management"
-
 
 # Properties for displaying the project in the project list
 card_image = "intu-logo.png"
-card_description = "Intu is a web-based learning platform that delivers educational content designed with students’ diverse learning preferences in mind in order to provide an individualized learning experience. The platform integrates interactive learning units and combines them with intuitive knowledge management, offering a comprehensive approach to knowledge acquisition and organization." 
+card_description = "Intu is a web-based learning platform that delivers educational content designed with students’ diverse learning preferences in mind to provide an individualized learning experience. The platform integrates interactive learning units and combines them with intuitive knowledge management, offering a comprehensive approach to knowledge acquisition and organization." 
 
 team = ["Piranavi Satkunanathan", "Martin Christian Solihin", "Alexander Brjazgunov", "Christopher Knapp", "Finja-Malin Scheltens", "Henry Ordelt"] 
 supervisor = "André Selmanagic"
@@ -16,14 +14,14 @@ draft = false
 {{<image src="Intu-header.png" alt="Mockup image for intu">}}
 
 {{<section title="Our Goal">}}
-Learning is not a one-size-fits-all process: it's a dynamic and unique journey that varies immensely from person to person. Some students may thrive in an auditory learning environment, where they can passively listen to explanations. Others may find their learning potential amplified when they're reading text or exploring concepts on their own and becoming fully engaged in the learning process. Still, most succeed best with a combination of different methods, blending various learning preferences to create an approach that's uniquely their own. Recognizing these preferences not only results in a faster and better comprehension of the learning content but also keeps students motivated.That’s why intu’s primary goal is to cater to these diverse learning preferences of students.
+Learning is not a one-size-fits-all process: it's a dynamic and unique journey that varies immensely from person to person. Some students may thrive in an auditory learning environment, where they can passively listen to explanations. Others may find their learning potential amplified when they're reading text or exploring concepts on their own and becoming fully engaged in the learning process. Still, most succeed best with a combination of different methods, blending various learning preferences to create an approach that's uniquely their own. Recognizing these preferences not only results in a faster and better comprehension of the learning content but also keeps students motivated.That’s why intu’s primary goal is to cater to students’ diverse learning preferences.
 
 {{</section>}}
 
 {{<section title="Main Ideas">}}
-In order to actively engage students in their learning journey, intu focuses on interactive content that promotes *learning by doing*, which not only makes learning more engaging, but also improves understanding and retention. Students can choose to listen to the content, read it like a book, or actively explore interactive components.
+In order to actively engage students in their learning journey, intu focuses on interactive content that promotes *learning by doing*, making learning more engaging and improving understanding and retention. Students can choose to listen to the content, read it like a book, or actively explore interactive components.
 
-It's important that content is carefully curated with a focus on didactical enhancement and a clear and comprehensive structure to improve the students' learning experience.
+Content must be carefully curated, focusing on didactical enhancement and a clear and comprehensive structure to improve the students' learning experience.
  A well-designed curriculum, with a balance of theory and practical application, enables students to connect new knowledge with existing understanding, facilitates a deeper understanding of the subject matter, and fosters critical thinking.
 
 Finally, intu acknowledges the importance of reflection and personal understanding in learning. That’s why it’s important to allow students to note their explanations and connecting thoughts without interrupting the learning process,stimulating a deeper understanding of the learning material.

content/ss23/master/m3-intu/challenges.md

@@ -0,0 +1,21 @@
++++
+title = "Challenges"
+weight = 3
++++
+
+{{<section title="Research for credible Sources">}}
+Finding reliable sources posed its own set of challenges. While we gathered valuable information from the lecture notes, we recognized the need to seek additional sources with verifiable credibility. Hence, a lot of research has been conducted. Moreover, we aspired to enhance the transparency of the educational content we provide by incorporating a 'Sources' button. This offers users the chance to immerse further into the subject matter, substantiating their understanding directly from the original resources.
+{{</section>}}
+
+{{<section title="Integrating Editor.js into our Knowledge Base">}}
+For our vision of creating a personal knowledge base by storing learning objects, we discovered the Editor.js library, which seemed perfect for our needs. However, one drawback was that it wasn't a React library like our project. Consequently, we encountered some challenges in using certain handy React features and had to implement workarounds. The editor itself is divided into various blocks, each representing different types like texts, headings, images, or our newly created learning object type. To incorporate our React learning objects into this editor, we had to create a new React root for each learning object. As a result, the blocks were not aware of our defined browser routes for handling navigation. Additionally, using contexts was not feasible within the blocks. To address these issues, we implemented an event bus for navigation, to which the page subscribes. When the navigation button is triggered, the editor block sends an event through the event bus.
+{{</section>}}
+
+{{<section title="Data Structure">}}
+Another aspect that we found challenging was defining the data structure for our learning objects. Our goal was to keep the learning objects as compact as possible to ensure maximum flexibility for users when storing them in the knowledge base. One crucial consideration was determining the level at which data retrieval should occur. We decided to retrieve the data once per learning object on each page. Essentially, the learning object acts as a container that holds all the small contents, such as text, images, and more, and it should be savable as well. To achieve this, we envisioned the contents as components that could be loaded independently of their parent (the learning object). However, we wanted to avoid redundant data retrieval for the same request.
+To address this issue, we considered implementing a cache or shared repository for the data. This would allow us to store and access the data efficiently, preventing multiple redundant requests. Unfortunately, due to time constraints, this feature concept did not make it into our final MVP.
+{{</section>}}
+
+{{<section title="Backend">}}
+Initially, we focused on the conception and implementation of different learning objects. Halfway through our project, we made the decision to set up a dedicated backend for data storage and retrieval. The primary motivation behind this strategic shift was to ensure the efficient management and smooth operation of our expanding content base. This enabled us to store, access, and manage data effectively, providing a more seamless learning experience for users. Therefore, resources had to be freed up to prepare the backend accordingly. In the end, however, this was a good decision, as it allowed us to implement a true full-stack application and thus address any other issues.
+{{</section>}}

content/ss23/master/m3-intu/features.md

@@ -3,16 +3,15 @@ title = "Features"
 weight = 1
 +++
 
-
-
 {{<section title="Interactive Learning Content">}}
 Intu incorporates interactive learning objects, providing users with the opportunity to actively engage with the content. This includes an animated, exploratory diagram that offers a guided view while also supporting full user control. In addition a practical implementation of the MVC Pattern enables students to better understand and explore relationships within the content. To ensure understanding and retention, Intu also features practical tasks for users to apply and test their newly acquired knowledge. In general Intu embodies a learning platform that purposefully uses interactive elements to maintain the learners attention.
+
 {{</section>}}
-{{<image src="Interactive.png" alt="Interactive learning content">}}
+{{<mediathek id="5f19ea860f6a255d872152d7fd578551" title="Video: Showcase of Interactive Example">}}
 
-{{<section title="Catering to Different Learning Preferences">}}
-Intu caters to a variety of learning preferences by providing students with diverse options to engage with the content, and most importantly, allowing them to choose how they want to engage with the content. Students can explore diagrams on their own and discover additional information by hovering over individual elements. For those who prefer a more passive approach, an explanatory video style is available, with full control over the playback speed and pausing when needed. 
-Traditional learners who learn best by reading benefit from a book-style presentation of the material. In addition, a text-to-speech feature is provided for auditory learners. 
+{{<section title="Catering to different Learning Preferences">}}
+Intu caters to a variety of learning preferences by providing students with diverse options to engage with the content, and most importantly, allowing them to choose how they want to engage with the content. Students can explore diagrams on their own and discover additional information by hovering over individual elements. For those who prefer a more passive approach, an explanatory video style is available, with full control over the playback speed and pausing when needed.
+Traditional learners who learn best by reading benefit from a book-style presentation of the material. In addition, a text-to-speech feature is provided for auditory learners.
 By providing multiple ways of interacting with the content, Intu gives students the freedom to choose the depth of information they need, making their learning experience truly unique.
 {{</section>}}
 {{<image src="LO-examples.png" alt="Variety of Learning Objects of Intu">}}
@@ -21,9 +20,6 @@ By providing multiple ways of interacting with the content, Intu gives students
 During a learning process, students often piece together their own ideas and thoughts.
 That's why Intu provides a built-in, central space, called the knowledge base, for creating and managing notes from different learning units
 
-The user-centric design gives users the flexibility to personalize their notes. A key feature is the ability to import existing learning objects directly into the knowledge base. 
-This feature facilitates an efficient note-taking process and increases productivity by allowing students to immediately record their insights and reflections of what they are learning.
-
 The user-centric design gives students the flexibility to personalize their notes. A key feature is the ability to import existing learning objects directly into the knowledge base. This integrated system allows for seamless transitions between knowledge base and learning units. The bidirectional design fosters sustainable learning, thereby creating a uniquely individualized learning journey.
 
 {{</section>}}
@@ -34,9 +30,9 @@ The skill path overview displays its learning topics within, and allows users to
 
 This page shows the individual progress for each learning unit as well as overall progress in the skill path, incorporating rudimentary gamification elements to boost learner motivation.
 
-The topic overview provides users with a deeper insight into the upcoming content within the selected learning unit. Users have the flexibility to start from the beginning or jump right into specific learning objects based on their preferences and needs. 
+The topic overview provides users with a deeper insight into the upcoming content within the selected learning unit. Users have the flexibility to start from the beginning or jump right into specific learning objects based on their preferences and needs.
 
 In the future, the skill path overview will let the user start practicing and testing directly from itself. This feature will provide users with a convenient way to actively engage with the content and assess their knowledge.
 
 {{</section>}}
-{{<image src="Dashboard-Topic.png" alt="Screenshot of the Skill Path Overview">}}
+{{<image src="Dashboard-Topic.png" alt="Screenshot of the Skill Path Overview">}}

content/ss23/master/m3-intu/future.md

@@ -0,0 +1,37 @@
++++
+title = "Future"
+weight = 5
++++
+
+During the creation of the MVP, certain features were excluded due to considerations of scope, time limitations, or their relative importance compared to the essential feature set. This section aims to highlight some of the features that may be added to intu in the future.
+
+{{<section title="Index Cards">}}
+One of the features that has already been fully designed for future integration is “Index Cards”. Users will not only be able to transfer learning content into the notes in the knowledge base but also create index cards from it. This will allow them to assemble a personalized collection of index cards to help them on their learning journey. The Index Card feature will include a customizable recap mode, including randomized or ordered self-testing. While keeping track of correct and incorrect answers, learners can prove their knowledge.
+{{</section>}}
+
+{{<image src="index-cards.png" caption="Index cards feature in the knowledge base" alt="Index cards feature in the knowledge base">}}
+
+{{<section title="Content Transfer">}}
+Users will have the ability to transfer content from learning objects in smaller pieces instead of having to move the whole page. This will give users the option to transfer specific items, such as a single image, portions of text, or certain steps of diagrams. This promotes a more individualized learning process, enabling learners to flexibly compile the content they need.
+{{</section>}}
+
+{{<section title="Enhancement of the Knowledge Base">}} 
+In the future, the knowledge base will also allow users to create additional pages. This feature will allow them to expand their learning space to provide more room for personalized content. In addition, the knowledge base will allow users to arrange their pages in a hierarchical order to create their own knowledge base structure.
+To increase ease of use, a search function for content within their pages and a favorite feature will be added. These enhancements will allow users to quickly find specific content and mark their favorite or frequently used pages for easier access.
+{{</section>}}
+
+{{<section title="Practice and Test Mode">}} 
+In the future, intu will encompass all phases of learning, ranging from understanding and practicing to revisiting and testing knowledge.
+In practice mode, users will have the opportunity to actively engage with exercises and then review the solutions along with supportive guidance. 
+On the other hand, the test mode is designed to allow users to certify their knowledge. 
+In this mode, results are only revealed after submission, and no hints or assistance are provided throughout the test. This mode aims to emulate a real-world exam setting, allowing users to accurately assess their understanding and readiness.
+{{</section>}}
+
+{{<section title="Hints">}} 
+In the future, intu will provide even more support to learners during tasks. Hints can be accessed within an exercise and provide varying levels of assistance, from subtle nudges to more comprehensive explanations. The inclusion of hints encourages self-directed learning, empowering learners to solve problems on their own. It also reduces frustration, as hints help learners get on the right track and guide them towards their goals.
+{{</section>}}
+
+{{<section title="Expanded Learning Offers">}} 
+Currently, intu represents only a single skill path along with a learning unit through which we aim to showcase our didactic concept. Our vision for the future of intu is to provide an extensive catalog of learning paths and topics from which learners can draw. This will allow for an even more personalized learning experience, tailored to the specific interests of each learner.
+{{</section>}}
+