Skip to content

Add Core Concepts and fix Introduction#1

Open
shehab-as wants to merge 14 commits intomainfrom
shehab/add-intro-and-structure
Open

Add Core Concepts and fix Introduction#1
shehab-as wants to merge 14 commits intomainfrom
shehab/add-intro-and-structure

Conversation

@shehab-as
Copy link
Collaborator

@shehab-as shehab-as commented Feb 22, 2026

  • Add a dedicated Core Concepts tab in the header (alongside Developer Guide and API Reference)
  • Revamped Developer Guide
  • Replaced Use cases with 4 How-to guides
  • Rewrote Quickstart
  • Added Overview with Data Model hierarchy
  • Added minimal intro to each page under Core Concepts section.

Note

Low Risk
Documentation-only changes (new pages and navigation restructuring) with no runtime or API behavior impact; main risk is broken links/IA regressions.

Overview
Adds a new Core Concepts documentation section (with an overview and individual pages for organizations, landscapes, versions, domains, model objects, model connections, diagrams, and flows) to explain the IcePanel data model and version scoping.

Reorganizes the docs IA in fern/docs.yml into three top-level tabs (Developer Guide, Core Concepts, API Reference), replacing the old intro pages with a new introduction + rewritten Quickstart, and swapping the prior “Use cases” content for four focused how-to guides (create objects, export data, update descriptions, create versions).

Written by Cursor Bugbot for commit a290245. This will update automatically on new commits. Configure here.

description: Make your first API call to IcePanel
---

Make your first API call to list your <Tooltip tip="Your primary workspace in IcePanel. It holds your architecture: objects, connections, diagrams, flows, and versions.">landscapes</Tooltip>.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tooltips are cool!


---

## Filtering model objects by domain
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome!

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

@shehab-as
Copy link
Collaborator Author

@VictorLeach96 all resolved

## Prerequisites

- [IcePanel account](https://app.icepanel.io/user/sign-up)
- [API key](https://app.icepanel.io)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This links just points to the app root level, will it be confusing to people maybe

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I initially wanted to point at /settings page, but its nested under

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm yes we don't have a deep link to our api keys

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants