From e79f26e11104524817700e8655c138da7795db65 Mon Sep 17 00:00:00 2001 From: Hadar Date: Sun, 25 May 2025 15:17:19 +0300 Subject: [PATCH 1/6] academy draft outline --- docs/academy/_category_.json | 6 +++ docs/academy/developer-track.md | 22 ++++++++ docs/academy/introduction.md | 69 +++++++++++++++++++++++++ docs/academy/platform-engineer-track.md | 21 ++++++++ docs/academy/sidebar.ts | 29 +++++++++++ docusaurus.config.js | 9 +++- sidebars.js | 6 ++- 7 files changed, 160 insertions(+), 2 deletions(-) create mode 100644 docs/academy/_category_.json create mode 100644 docs/academy/developer-track.md create mode 100644 docs/academy/introduction.md create mode 100644 docs/academy/platform-engineer-track.md create mode 100644 docs/academy/sidebar.ts diff --git a/docs/academy/_category_.json b/docs/academy/_category_.json new file mode 100644 index 0000000000..6d7f7900ec --- /dev/null +++ b/docs/academy/_category_.json @@ -0,0 +1,6 @@ +{ + "position": 0, + "className": "hidden", + "collapsible": false, + "collapsed": false +} diff --git a/docs/academy/developer-track.md b/docs/academy/developer-track.md new file mode 100644 index 0000000000..60ffa00e40 --- /dev/null +++ b/docs/academy/developer-track.md @@ -0,0 +1,22 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Developer track + +This track is designed for the personas who will be **using** (as opposed to building) the internal developer portal. + +It is focused on describing the different components of your portal (software catalog, actions, scorecards, etc.) and how to use them to accommodate your routines and workflows. + + + + + + + + + + + + + + diff --git a/docs/academy/introduction.md b/docs/academy/introduction.md new file mode 100644 index 0000000000..7ec2a531b3 --- /dev/null +++ b/docs/academy/introduction.md @@ -0,0 +1,69 @@ +--- +id: introduction +sidebar_position: 1 +description: Learn how to build and scale Internal Developer Portals with Port Academy's tutorials, certifications, and guided tracks. +--- + +import Button from '@mui/material/Button'; + +# Introduction + +Welcome to Port's Academy — your dedicated learning space for mastering how to build, manage, and scale an **internal developer portal (IDP)** using Port. + +Whether you are just getting started or aiming to deepen your expertise, Port Academy offers hands-on, structured learning paths to help you unlock the full potential of Port. + +Access is completely free and open to everyone. + +## What's in the academy? + +Port's academy is a collection of structured tutorials and guided tracks to help you build, scale, manage, and use your developer portal. + +It includes guides, videos, and other resources to help you get the most out of Port. + + + + + + + +--- + +## Ready to start? + +Choose the relevant track to get started: + +- [**Platform Engineer Track**](/academy/platform-engineer-track) + Learn how to build scalable IDPs using blueprints, scorecards, automation, and governance workflows. + +- [**Developer Track**](/academy/developer-track) + Learn how to interact with the catalog, understand scorecards, and trigger actions that integrate with your developer workflow. + +--- + +## Join the community + +Learning is better together. Connect with us and others building with Port: + +- [Join our community](https://port.io/community) +- [Check out Port's events and webinars](https://port.io/webinars) \ No newline at end of file diff --git a/docs/academy/platform-engineer-track.md b/docs/academy/platform-engineer-track.md new file mode 100644 index 0000000000..4e39f49025 --- /dev/null +++ b/docs/academy/platform-engineer-track.md @@ -0,0 +1,21 @@ +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +# Platform engineer track + +This track is designed for the personas who will be **building** and **scaling** the developer portal. + +It is focused on creating experiences for the developers who will be using the portal, using blueprints, actions, automations, scorecards, and all the other features that Port has to offer. + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/academy/sidebar.ts b/docs/academy/sidebar.ts new file mode 100644 index 0000000000..578cb8293a --- /dev/null +++ b/docs/academy/sidebar.ts @@ -0,0 +1,29 @@ +import type { SidebarsConfig } from "@docusaurus/plugin-content-docs"; + +const sidebar: SidebarsConfig = { + academySidebar: [ + { + type: "doc", + id: "academy/introduction", + }, + { + type: "html", + value: '
', + }, + { + type: "doc", + id: "academy/platform-engineer-track", + }, + { + type: "doc", + id: "academy/developer-track", + }, + // { + // type: "doc", + // id: "guides/guides", + // }, + //{type: 'autogenerated', dirName: 'academy'}, + ], +}; + +export default sidebar.academySidebar; diff --git a/docusaurus.config.js b/docusaurus.config.js index f2e71a3310..2f410e2486 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -94,7 +94,7 @@ const config = { label: "Home", position: "left", className: "header-home-link", - activeBaseRegex: "^((?!api-reference|guides).)*$", + activeBaseRegex: "^((?!api-reference|guides|academy).)*$", }, { to: "/api-reference/port-api", @@ -110,6 +110,13 @@ const config = { className: "header-guides-link", activeBasePath: "guides", }, + { + to: "/academy/introduction", + label: "Academy", + position: "left", + className: "header-academy-link", + activeBasePath: "academy", + }, { to: "https://github.com/port-labs/port-docs", position: "right", diff --git a/sidebars.js b/sidebars.js index f24921bca2..716d31963b 100644 --- a/sidebars.js +++ b/sidebars.js @@ -14,6 +14,7 @@ import { ClassNames } from '@emotion/react'; import apiSidebar from './docs/api-reference/sidebar.ts'; import guidessidebar from './docs/guides/sidebar.ts'; +import academySidebar from './docs/academy/sidebar.ts'; /** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */ const sidebars = { @@ -24,7 +25,10 @@ const sidebars = { ], "guides-sidebar": [ guidessidebar, - ] + ], + "academy-sidebar": [ + academySidebar, + ], // But you can create a sidebar manually /* tutorialSidebar: [ From 001aa0d97d33cbe422e0af0f271a6ccd40d3fa10 Mon Sep 17 00:00:00 2001 From: Hadar Date: Mon, 2 Jun 2025 15:21:59 +0300 Subject: [PATCH 2/6] academy draft outline --- docs/academy/developer-track.md | 85 +++++++++++- docs/academy/developer-track.module.css | 98 ++++++++++++++ docs/academy/platform-engineer-track.md | 167 +++++++++++++++++++++++- 3 files changed, 342 insertions(+), 8 deletions(-) create mode 100644 docs/academy/developer-track.module.css diff --git a/docs/academy/developer-track.md b/docs/academy/developer-track.md index 60ffa00e40..edafaa7fac 100644 --- a/docs/academy/developer-track.md +++ b/docs/academy/developer-track.md @@ -1,5 +1,6 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +import styles from './developer-track.module.css'; # Developer track @@ -7,16 +8,88 @@ This track is designed for the personas who will be **using** (as opposed to bui It is focused on describing the different components of your portal (software catalog, actions, scorecards, etc.) and how to use them to accommodate your routines and workflows. - - +## Available Courses +
+
+
📚
+

Getting Started with Port

+
+ Video + Guide +
+

Learn the basics of navigating and using your developer portal effectively.

+ + Start Learning → + +
+
+
🔍
+

Software Catalog Mastery

+
+ Documentation + Guide +
+

Discover how to effectively use the software catalog to find and manage your services.

+ + Start Learning → + +
- +
+
⚡
+

Working with Actions

+
+ Video + Documentation +
+

Master the use of self-service actions to streamline your development workflows.

+ + Start Learning → + +
- +
+
📊
+

Understanding Scorecards

+
+ Guide + Documentation +
+

Learn how to interpret and use scorecards to track service health and metrics.

+ + Start Learning → + +
- - +
+
🔔
+

Notifications & Alerts

+
+ Video + Guide +
+

Configure and manage notifications to stay informed about important updates.

+ + Start Learning → + +
+
+
🤝
+

Team Collaboration

+
+ Guide + Documentation +
+

Learn best practices for collaborating with your team using Port's features.

+ + Start Learning → + +
+
+:::tip Course Navigation +Each course is designed to be self-contained and can be taken in any order. However, we recommend starting with "Getting Started with Port" if you're new to the platform. +::: diff --git a/docs/academy/developer-track.module.css b/docs/academy/developer-track.module.css new file mode 100644 index 0000000000..8316126655 --- /dev/null +++ b/docs/academy/developer-track.module.css @@ -0,0 +1,98 @@ +.courseGrid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); + gap: 2rem; + margin: 2rem 0; +} + +.courseCard { + background: var(--ifm-card-background-color); + border-radius: 8px; + padding: 1.5rem; + box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1); + transition: transform 0.2s ease, box-shadow 0.2s ease; + display: flex; + flex-direction: column; + height: 100%; + border: 1px solid var(--ifm-color-emphasis-200); +} + +.courseCard:hover { + transform: translateY(-4px); + box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); +} + +.courseIcon { + font-size: 2rem; + margin-bottom: 1rem; +} + +.courseCard h3 { + margin: 0 0 0.75rem 0; + color: var(--ifm-heading-color); + font-size: 1.25rem; +} + +.courseCard p { + color: var(--ifm-color-emphasis-700); + margin-bottom: 1.5rem; + flex-grow: 1; + font-size: 0.95rem; + line-height: 1.5; +} + +.courseTags { + display: flex; + flex-wrap: wrap; + gap: 0.5rem; + margin-bottom: 1rem; +} + +.courseTag { + font-size: 0.75rem; + padding: 0.25rem 0.75rem; + border-radius: 12px; + font-weight: 500; + background: var(--ifm-color-emphasis-100); + color: var(--ifm-color-emphasis-700); +} + +.courseTag.video { + background: #e3f2fd; + color: #1976d2; +} + +.courseTag.guide { + background: #e8f5e9; + color: #2e7d32; +} + +.courseTag.documentation { + background: #fff3e0; + color: #f57c00; +} + +.courseLink { + display: inline-block; + color: var(--ifm-color-primary); + text-decoration: none; + font-weight: 500; + transition: color 0.2s ease; + margin-top: auto; +} + +.courseLink:hover { + color: var(--ifm-color-primary-darker); + text-decoration: none; +} + +@media (max-width: 768px) { + .courseGrid { + grid-template-columns: 1fr; + gap: 1.5rem; + } + + .courseCard { + padding: 1.25rem; + } +} \ No newline at end of file diff --git a/docs/academy/platform-engineer-track.md b/docs/academy/platform-engineer-track.md index 4e39f49025..f7af1599b0 100644 --- a/docs/academy/platform-engineer-track.md +++ b/docs/academy/platform-engineer-track.md @@ -1,5 +1,6 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +import styles from './developer-track.module.css'; # Platform engineer track @@ -7,15 +8,177 @@ This track is designed for the personas who will be **building** and **scaling** It is focused on creating experiences for the developers who will be using the portal, using blueprints, actions, automations, scorecards, and all the other features that Port has to offer. - + +
+
+
🚀
+

Getting Started with Port

+
+ Video + Guide +
+

Learn the basics of Port, understand key concepts, and set up your first developer portal.

+ + Start Learning → + +
+ +
+
📋
+

Creating Your First Blueprint

+
+ Guide + Documentation +
+

Master the fundamentals of blueprints and learn how to model your software catalog.

+ + Start Learning → + +
+ +
+
⚡
+

Basic Actions & Automations

+
+ Video + Guide +
+

Discover how to create and manage actions and automations in your developer portal.

+ + Start Learning → + +
+
+
📊
+

Scorecards Fundamentals

+
+ Guide + Documentation +
+

Learn how to create and use scorecards to measure and improve your software development practices.

+ + Start Learning → + +
+ +
+
🎨
+

Port UI Customization

+
+ Video + Guide +
+

Customize your developer portal's look and feel to match your organization's branding.

+ + Start Learning → + +
+ +
+
👥
+

User Management

+
+ Guide + Documentation +
+

Learn how to manage users, roles, and permissions in your developer portal.

+ + Start Learning → + +
+
 +
+
+
🏗️
+

Advanced Blueprint Patterns

+
+ Documentation + Guide +
+

Learn advanced blueprint techniques for complex software catalog modeling and relationships.

+ + Start Learning → + +
+ +
+
🔌
+

Custom Integrations

+
+ Video + Documentation +
+

Build custom integrations with external tools and services using Port's API and webhooks.

+ + Start Learning → + +
+ +
+
📈
+

Advanced Scorecards & Metrics

+
+ Guide + Documentation +
+

Create sophisticated scorecards and metrics to measure and improve your software development lifecycle.

+ + Start Learning → + +
+ +
+
⚙️
+

Advanced Automation Patterns

+
+ Video + Guide +
+

Implement complex automation workflows and integrate with your existing DevOps toolchain.

+ + Start Learning → + +
+ +
+
🧩
+

Custom Widgets & Extensions

+
+ Documentation + Guide +
+

Extend Port's functionality with custom widgets and extensions for specialized use cases.

+ + Start Learning → + +
+ +
+
🏢
+

Enterprise Integration Patterns

+
+ Guide + Documentation +
+

Learn best practices for integrating Port with enterprise systems and scaling your developer portal.

+ + Start Learning → + +
+
+ - \ No newline at end of file + + +:::tip Track Progression +The beginner track focuses on fundamental concepts and basic implementations, while the advanced track covers complex patterns and enterprise-scale solutions. We recommend completing the beginner track before moving to advanced topics. +::: \ No newline at end of file From 90421ee664c17d9f7e9dcb429fc15929a23383e5 Mon Sep 17 00:00:00 2001 From: Hadar Date: Mon, 2 Jun 2025 16:40:29 +0300 Subject: [PATCH 3/6] academy draft outline --- docs/academy/developer-track.md | 8 +- docs/academy/example-course.md | 441 ++++++++++++++++++++++++ docs/academy/next-steps.md | 27 ++ docs/academy/platform-engineer-track.md | 10 +- docs/academy/sidebar.ts | 8 + 5 files changed, 485 insertions(+), 9 deletions(-) create mode 100644 docs/academy/example-course.md create mode 100644 docs/academy/next-steps.md diff --git a/docs/academy/developer-track.md b/docs/academy/developer-track.md index edafaa7fac..7c6d3b44ee 100644 --- a/docs/academy/developer-track.md +++ b/docs/academy/developer-track.md @@ -8,7 +8,9 @@ This track is designed for the personas who will be **using** (as opposed to bui It is focused on describing the different components of your portal (software catalog, actions, scorecards, etc.) and how to use them to accommodate your routines and workflows. -## Available Courses +## Available courses + +Courses are designed to be self-contained and can be taken in any order:
@@ -89,7 +91,3 @@ It is focused on describing the different components of your portal (software ca
- -:::tip Course Navigation -Each course is designed to be self-contained and can be taken in any order. However, we recommend starting with "Getting Started with Port" if you're new to the platform. -::: diff --git a/docs/academy/example-course.md b/docs/academy/example-course.md new file mode 100644 index 0000000000..4af2b55857 --- /dev/null +++ b/docs/academy/example-course.md @@ -0,0 +1,441 @@ +--- +title: Getting Started with Port +description: Master the fundamentals of Port and learn how to build your first software catalog +courseId: getting-started-101 +level: Beginner +duration: 45 minutes +prerequisites: None +--- + +# Getting Started with Port + +
+
+
+
⏱️
+
+ Duration + 45 minutes +
+
+
+
📚
+
+ Modules + 3 +
+
+
+
🎯
+
+ Track + Developer +
+
+
+
+ +## Prerequisites + +:::info Before you begin +This course is designed for developers and technical team members who want to create and manage a software catalog. While no prior experience with Port is required, the following will help you get the most out of this course: +::: + +### Required Prerequisites +- Access to a Port account (you can [sign up for free](https://app.getport.io/signup)) +- Basic understanding of software development concepts +- Familiarity with web browsers and modern development tools + +### Recommended Prerequisites +- Basic knowledge of YAML/JSON (for blueprint definitions) +- Understanding of software architecture concepts +- Experience with developer tools and APIs + +### Helpful but Optional +- Experience with software cataloging tools +- Knowledge of microservices architecture +- Familiarity with Git and version control + +## Course Overview + +Welcome to your journey with Port! This course will guide you through the essential concepts and practical steps to get started with Port's software catalog platform. By the end of this course, you'll have a solid foundation and be ready to build your first software catalog. + +:::tip What you'll learn +- Understanding Port's core concepts and terminology +- Setting up your first software catalog +- Creating and managing blueprints +- Adding your first entities +- Basic catalog navigation and search +- Best practices for getting started +::: + +## Course Modules + +### Module 1: Introduction to Port (10 minutes) + +:::info Core Concepts +Port is a developer portal that helps you create a comprehensive software catalog. Think of it as a single source of truth for all your software assets, services, and resources. +::: + +#### What is a Software Catalog? + +A software catalog is a centralized inventory of all your software assets, including: +- Microservices and applications +- Infrastructure components +- APIs and endpoints +- Documentation and runbooks +- Team ownership and responsibilities + +#### Why Use Port? + +Port provides several key benefits: +1. **Centralized Knowledge**: All your software assets in one place +2. **Improved Visibility**: Clear understanding of your software landscape +3. **Better Collaboration**: Shared context for all team members +4. **Automated Updates**: Keep your catalog in sync with your actual infrastructure +5. **Developer Experience**: Self-service access to critical information + +#### Key Use Cases + +Port helps you: +- Onboard new team members faster +- Track service dependencies +- Manage technical documentation +- Monitor service health +- Enforce best practices +- Automate compliance reporting + +#### Port's Architecture + +Port's architecture consists of three main components: +1. **Blueprints**: Define the structure of your catalog items +2. **Entities**: The actual catalog items (services, applications, etc.) +3. **Relationships**: Define how different entities are connected + +### Module 2: Setting Up Your Environment (15 minutes) + +:::caution Prerequisites +Before starting this module, ensure you have: +- Access to a Port account +- Required permissions in your organization +- Basic understanding of YAML/JSON +::: + +#### Creating Your Port Account + +1. Visit [app.getport.io/signup](https://app.getport.io/signup) +2. Choose your authentication method (GitHub, Google, or email) +3. Complete the onboarding process +4. Set up your organization profile + +#### Understanding the Port Interface + +The Port interface consists of several key areas: +- **Dashboard**: Overview of your catalog +- **Blueprints**: Define and manage your catalog structure +- **Entities**: View and manage your catalog items +- **Settings**: Configure your workspace +- **API**: Access Port programmatically + +#### Configuring Your Workspace + +1. **Organization Settings** + - Set your organization name and logo + - Configure authentication methods + - Set up team roles and permissions + +2. **Workspace Configuration** + - Choose your default view + - Set up notifications + - Configure integrations + +3. **Initial Setup** + - Create your first blueprint + - Set up basic entity types + - Configure default views + +#### Setting Up Initial Integrations + +Port can integrate with various tools: +- **Git Providers**: GitHub, GitLab, Bitbucket +- **CI/CD Tools**: Jenkins, GitHub Actions, GitLab CI +- **Cloud Providers**: AWS, GCP, Azure +- **Monitoring Tools**: Datadog, New Relic, Grafana + +### Module 3: Building Your First Catalog (20 minutes) + +:::warning Best Practice +Start small and iterate! Begin with a few key blueprints and entities, then expand your catalog as you become more comfortable with Port's features. +::: + +#### Creating Your First Blueprint + +1. **Define Blueprint Properties** + ```yaml + identifier: service + title: Service + properties: + - identifier: name + type: string + title: Name + - identifier: description + type: string + title: Description + - identifier: owner + type: string + title: Owner + ``` + +2. **Add Required Fields** + - Choose mandatory properties + - Set validation rules + - Define default values + +3. **Configure Relationships** + - Define entity connections + - Set up dependency tracking + - Configure ownership links + +#### Adding Your First Entities + +1. **Create a Service Entity** + - Fill in basic information + - Add documentation + - Set up relationships + +2. **Define Entity Properties** + - Add custom properties + - Set up calculated fields + - Configure validation + +3. **Link Related Entities** + - Connect to other services + - Define dependencies + - Set up ownership + +#### Understanding Relationships + +Port supports various relationship types: +- **Ownership**: Who owns the service +- **Dependencies**: What other services this depends on +- **Documentation**: Links to relevant docs +- **Monitoring**: Associated dashboards and alerts + +#### Basic Catalog Navigation + +1. **Using the Search** + - Full-text search + - Property filters + - Relationship queries + +2. **Viewing Entities** + - List view + - Card view + - Table view + - Custom views + +3. **Managing Updates** + - Manual updates + - Automated sync + - Change history + +## Hands-on Exercises + +Each module includes practical exercises to reinforce your learning: + +1. **Create a Service Blueprint** + - Define a basic service blueprint + - Add required properties + - Set up relationships + - Test the blueprint + +2. **Add Catalog Entities** + - Create a new service + - Add documentation + - Set up monitoring links + - Configure ownership + +3. **Set Up Relationships** + - Connect services + - Define dependencies + - Create ownership links + - Test relationship queries + +4. **Practice Navigation** + - Use different views + - Try advanced search + - Filter and sort + - Export data + +## Additional Resources + +- [Port Documentation](/) +- [Community Forums](https://community.getport.io) +- [API Reference](/api-reference) +- [Example Catalogs](/examples) + +:::tip Next Steps +After completing this course, we recommend: +- Exploring the [Advanced Catalog Management](/academy/advanced-catalog) course +- Joining our [community forums](https://community.getport.io) +- Checking out our [example catalogs](/examples) +::: + +## Course Completion + +To complete this course: +1. Work through all modules +2. Complete the hands-on exercises +3. Take the final assessment +4. Receive your course completion certificate + + diff --git a/docs/academy/next-steps.md b/docs/academy/next-steps.md new file mode 100644 index 0000000000..fa9fee388d --- /dev/null +++ b/docs/academy/next-steps.md @@ -0,0 +1,27 @@ +# NOTES + +- Developer track should not have advanced courses. + +- No registration flow is needed. + +- A new kind of written content is required for some of the guides - a bit more explanatory, and less guide-like. The focus should be on the "why" as much as the "how". + +- Implementation guide - from some feedback we got, it is not being used very often. Regardless, Eric and his colleagues are working on enhancing it. + I think we should remove it and incorporate it as material for relevant courses. + +## Next steps + +- Finish mapping out the courses for all tracks and tiers. + +- Map out the delta between what we have and what we need to write. + +- Prioritize which courses should have videos. + +- End of chapter content? Not sure. + + + + + + + diff --git a/docs/academy/platform-engineer-track.md b/docs/academy/platform-engineer-track.md index f7af1599b0..a2b39a848a 100644 --- a/docs/academy/platform-engineer-track.md +++ b/docs/academy/platform-engineer-track.md @@ -8,6 +8,12 @@ This track is designed for the personas who will be **building** and **scaling** It is focused on creating experiences for the developers who will be using the portal, using blueprints, actions, automations, scorecards, and all the other features that Port has to offer. +## Available courses + +The content is organized into two tiers: beginner and advanced. + +The beginner tier focuses on fundamental concepts and basic implementations, while the advanced tier covers complex use-cases and capabilities. We recommend completing the beginner tier before moving to advanced topics. + @@ -178,7 +184,3 @@ It is focused on creating experiences for the developers who will be using the p - -:::tip Track Progression -The beginner track focuses on fundamental concepts and basic implementations, while the advanced track covers complex patterns and enterprise-scale solutions. We recommend completing the beginner track before moving to advanced topics. -::: \ No newline at end of file diff --git a/docs/academy/sidebar.ts b/docs/academy/sidebar.ts index 578cb8293a..8e4d408b60 100644 --- a/docs/academy/sidebar.ts +++ b/docs/academy/sidebar.ts @@ -18,6 +18,14 @@ const sidebar: SidebarsConfig = { type: "doc", id: "academy/developer-track", }, + { + type: "doc", + id: "academy/next-steps", + }, + { + type: "doc", + id: "academy/example-course", + }, // { // type: "doc", // id: "guides/guides", From 4e643c71ec46a7ff81cd8754bcebe1ae9ff77aef Mon Sep 17 00:00:00 2001 From: Hadar Date: Tue, 3 Jun 2025 10:16:08 +0300 Subject: [PATCH 4/6] academy draft outline --- docs/academy/example-course.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/academy/example-course.md b/docs/academy/example-course.md index 4af2b55857..1b1844e0d5 100644 --- a/docs/academy/example-course.md +++ b/docs/academy/example-course.md @@ -271,12 +271,11 @@ Each module includes practical exercises to reinforce your learning: - [Port Documentation](/) - [Community Forums](https://community.getport.io) -- [API Reference](/api-reference) -- [Example Catalogs](/examples) +- [API Reference](/) +- [Example Catalogs](/) :::tip Next Steps After completing this course, we recommend: -- Exploring the [Advanced Catalog Management](/academy/advanced-catalog) course - Joining our [community forums](https://community.getport.io) - Checking out our [example catalogs](/examples) ::: From 703718e7b72d9c6686fca31f0103c60d0c8975a9 Mon Sep 17 00:00:00 2001 From: Hadar Date: Tue, 3 Jun 2025 10:22:26 +0300 Subject: [PATCH 5/6] academy draft outline --- docs/academy/example-course.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/academy/example-course.md b/docs/academy/example-course.md index 1b1844e0d5..00fe791bc4 100644 --- a/docs/academy/example-course.md +++ b/docs/academy/example-course.md @@ -277,7 +277,7 @@ Each module includes practical exercises to reinforce your learning: :::tip Next Steps After completing this course, we recommend: - Joining our [community forums](https://community.getport.io) -- Checking out our [example catalogs](/examples) +- Checking out our [example catalogs](/) ::: ## Course Completion From 20353a5a3b1cf2afeb9356760297b79ceb319281 Mon Sep 17 00:00:00 2001 From: Hadar Date: Tue, 3 Jun 2025 12:44:38 +0300 Subject: [PATCH 6/6] academy draft outline --- docs/academy/next-steps.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/academy/next-steps.md b/docs/academy/next-steps.md index fa9fee388d..106e955dee 100644 --- a/docs/academy/next-steps.md +++ b/docs/academy/next-steps.md @@ -9,6 +9,8 @@ - Implementation guide - from some feedback we got, it is not being used very often. Regardless, Eric and his colleagues are working on enhancing it. I think we should remove it and incorporate it as material for relevant courses. +- The sidebar will only have an intro page and the 2 tracks. + ## Next steps - Finish mapping out the courses for all tracks and tiers.