developer-roadmap changelog

This commit introduces a significant enhancement by implementing an AI tutor feature within the topics section of the application. The update includes the addition of predefined messages, new explainer actions, and improvements to the UI for better navigation and user experience. Key components related to AI course subjects and topic interactions were modified or added, such as the TopicDetailAI, PredefinedActionGroup, and various UI elements to facilitate user engagement with the AI tutor.

Additionally, the commit reflects ongoing refinements, including the removal of unnecessary JSON structures, updates to contribution URLs, and various fixes to UI elements to ensure consistency and functionality. The changes span multiple files, indicating a comprehensive approach to integrating the AI tutor feature, enhancing both the backend logic and frontend presentation. Co-authored by Kamran Ahmed, this commit marks a substantial step forward in the platform's educational capabilities.

Files changed

• src/components/CustomRoadmap/CustomRoadmap.tsx
• src/components/GenerateCourse/AICourseLessonChat.tsx
• src/components/GenerateCourse/GenerateAICourse.tsx
• src/components/TopicDetail/PredefinedActionGroup.tsx
• src/components/TopicDetail/PredefinedActions.tsx
• src/components/TopicDetail/ResourceListSeparator.tsx
• src/components/TopicDetail/TopicDetail.tsx
• src/components/TopicDetail/TopicDetailAI.tsx
• src/components/TopicDetail/TopicDetailLink.tsx
• src/components/TopicDetail/TopicDetailsTabs.tsx
• src/components/TopicDetail/TopicProgressButton.tsx
• src/data/roadmaps/frontend/content/how-does-the-internet-work@yCnn-NfSxIybUQ2iTuUGq.md
• src/data/roadmaps/frontend/content/internet@VlNNwIEDWqQXtqkHWJYzC.md
• src/helper/generate-ai-course.ts
• src/hooks/use-keydown.ts
• src/pages/[roadmapId]/index.astro
• src/pages/best-practices/[bestPracticeId]/index.astro
• src/queries/roadmap-tree.ts

This commit introduces the @book@ tag to the project's documentation, following a suggestion from a Discord conversation with a user named Kamran, who confirmed its validity as a content type. The addition of this tag aims to enhance content categorization and improve the display of resources on the roadmap.

The change is reflected in the contributing.md file, where the @book@ tag is added to the list of valid types, which already includes @course@, @podcast@, and @video@. This modification emphasizes the importance of using appropriate tags for content organization, ensuring that resources are accurately categorized and easily accessible.

Files changed

• contributing.md

This commit introduces a new feature that adds the capability to handle a creator ID in the AI course generation process. In the GenerateAICourse component, the previous reliance on user authentication to obtain the current user's ID has been replaced with a state variable for the creator ID. This change allows the component to directly manage the creator ID through a new state hook, which is passed down to the AICourseContent component.

Additionally, the generateCourse helper function has been updated to accommodate the extraction and processing of the creator ID from generated course data. A regular expression is now implemented to identify the creator ID within the output, and the extracted value is subsequently passed to the relevant callback function. Overall, these modifications enhance the flexibility of the course creation process by allowing for more dynamic handling of creator information.

Files changed

• src/components/GenerateCourse/GenerateAICourse.tsx
• src/helper/generate-ai-course.ts

This commit addresses the issue of course access for non-logged-in users in the TopicDetailAI component. It introduces a conditional check that prevents users who are not logged in from accessing certain features. When a non-logged-in user attempts to click on a link, the event is canceled, and a login prompt is triggered instead.

Additionally, the commit includes a safeguard for users who have exceeded their usage limits, prompting them to consider an upgrade if they attempt to access restricted content. Overall, these changes enhance the user experience by ensuring that only authorized users can access specific functionalities while guiding them toward necessary actions like logging in or upgrading their account.

Files changed

• src/components/TopicDetail/TopicDetailAI.tsx

This commit modifies the CourseAnnouncement component to implement a functionality that hides the announcement for three days after a user dismisses it. The change introduces a new constant, COURSE_ANNOUNCEMENT_STORAGE_KEY, which is used to store the timestamp of when the announcement was closed in the local storage. The component checks this timestamp to determine whether to display the announcement, ensuring it only appears if three days have passed since it was dismissed.

Additionally, the code refactors the visibility logic and enhances the styling of the announcement. It sets a timer to reveal the announcement five seconds after the component mounts, but only if the three-day condition is met. When the user decides to close the announcement, the current timestamp plus three days is saved to local storage, effectively preventing the announcement from appearing again until the specified time has elapsed.

Files changed

• src/components/SQLCourse/CourseAnnouncement.tsx

The commit titled "fix: add a default subject" introduces modifications to the TopicDetailAI.tsx component within the source code. This update adds a default subject feature to enhance the user experience when no specific subjects are available in the roadmapTreeMapping. The changes include a new conditional check that determines if subjects exist or if the text can be split into parts, allowing the component to render a default subject link when no subjects are found. The addition of a ChevronRightIcon provides a visual cue for navigation within the text.

Overall, the commit involves 27 lines of new code, 3 lines removed, and several adjustments to enhance the component's functionality and user interface. The implementation ensures that users are still provided with relevant navigation options even when specific subjects are absent, thereby improving the accessibility and usability of the Topic Detail AI feature.

Files changed

• src/components/TopicDetail/TopicDetailAI.tsx

This commit enhances the existing documentation on Object-Oriented Programming (OOP) by adding an introductory article and a video resource aimed at simplifying the concepts of OOP. The modifications were made to the oop-basics.md file, which includes a brief overview of OOP principles such as encapsulation, inheritance, and polymorphism.

Additionally, the commit introduces a link to a video titled "Object-Oriented Programming (Simplified)" to provide users with a visual and more accessible way to understand OOP fundamentals. The changes were co-authored by Kamran Ahmed, indicating collaborative efforts to improve the educational resources available for programming fundamentals.

Files changed

• src/data/roadmaps/datastructures-and-algorithms/content/programming-fundamentals/oop-basics.md

The commit introduces a new feature for creating courses within the application, as indicated by the "feat: create new course" message. It includes the implementation of a CreateCourseModal component, which allows users to input a subject they wish to learn about and then generates a course based on that input. The modal is integrated into the existing UI, with a button to trigger the modal and a form to handle user input. Additionally, it contains updates to the SEO keywords related to the roadmap, enhancing the application's search engine optimization.

Furthermore, the commit addresses user access issues by fixing the ability for non-logged-in users to access courses. The changes span multiple components, including modifications to TopicDetailAI and TopicDetail, where the new modal is invoked. The commit also features contributions from multiple co-authors, showcasing collaborative development efforts. Overall, this update enhances user experience by facilitating course creation and improving the platform's visibility through SEO enhancements.

Files changed

• src/components/TopicDetail/CreateCourseModal.tsx
• src/components/TopicDetail/TopicDetail.tsx
• src/components/TopicDetail/TopicDetailAI.tsx

The commit involves the removal of the frontend-vs-backend AI feature from the codebase. This decision likely stems from a reassessment of its relevance or effectiveness in the current project context.

The changes made in this commit suggest a shift in focus, possibly streamlining the code and improving overall performance by eliminating unnecessary components. Further details on the specific alterations were not provided, but the removal indicates a strategic pivot in the development process.

Files changed

The commit titled "Add content to blockchain roadmap (#8555)" enhances the blockchain roadmap by incorporating various beginner-friendly educational resources, particularly from Bankless Academy, aimed at helping users understand blockchain concepts. It includes new links to Ethereum resources, dApp exploration tools, and addresses formatting issues across multiple files. Notably, the commit also reverts a previous addition of resources from Bankless Academy, indicating a shift in the approach to curating educational content.

In addition to the educational resources, the commit modifies existing entries to improve clarity and accessibility. Key updates include adding articles about Ethereum wallets, dApps, smart contracts, and zero-knowledge proofs, thereby enriching the roadmap with valuable information for users seeking to learn about these topics. Overall, the changes aim to create a more comprehensive and user-friendly resource for individuals interested in blockchain technology.

Files changed

• src/data/roadmaps/blockchain/content/crypto-wallets@SM8Wt3iNM_nncLj69KCuy.md
• src/data/roadmaps/blockchain/content/cryptowallets@FSThY0R1OAZCIL98W3AMj.md
• src/data/roadmaps/blockchain/content/dapps---decentralized-applications@SXXvFtf_7Rx64cHSEWxMS.md
• src/data/roadmaps/blockchain/content/javascript@fF06XiQV4CPEJnt_ESOvv.md
• src/data/roadmaps/blockchain/content/security@PBTrg9ivOpw9uNTVisIpx.md
• src/data/roadmaps/blockchain/content/smart-contracts@BV6lEwCAKaYxSPWD0LV_d.md
• src/data/roadmaps/blockchain/content/zk-rollups--zero-knowledge-proof@PykoX4j5Q3eJWIpUoczjM.md

The commit addresses the issue of a broken link in the documentation related to the role of an AI Engineer. Specifically, the link that previously directed users to information about the "advantages and disadvantages of AI" has been removed from the section that describes the responsibilities and focus areas of AI Engineers. This change is part of an update to the file ai-engineer.md, ensuring that the content remains relevant and functional.

In addition to the link removal, the overall description of the AI Engineer's role has been retained, emphasizing their use of pre-trained models and existing AI tools to enhance user experiences. The commit was co-authored by Kamran Ahmed, indicating a collaborative effort in maintaining the documentation's accuracy and quality.

Files changed

• src/data/roadmaps/ai-engineer/ai-engineer.md

This commit introduces LinkedIn and Bluesky social media links to the footer of the website. Modifications were made to the Footer.astro component, where two new anchor tags were added: one linking to the LinkedIn page of the project and another linking to the Bluesky profile. The LinkedIn icon was incorporated using an existing component, while a new SVG icon for Bluesky was added to the project.

Additionally, the settings.json file was updated to reflect a new last update check timestamp. The changes enhance the footer's functionality by providing users with direct access to the project's social media profiles, thereby improving engagement and visibility on these platforms.

Files changed

• .astro/settings.json
• src/components/Footer.astro
• src/icons/blusky.svg