Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 51 additions & 18 deletions fern/assets/styles.css
Original file line number Diff line number Diff line change
Expand Up @@ -67,12 +67,12 @@
margin: 0.5rem 1rem 0 1rem;
}

.fern-product-selector-radio-group {
.fern-product-selector-radio-group {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 1.5rem;
padding: 1.25rem;
height: 164px;
height: 248px;

> a {
max-width: 320px;
Expand Down Expand Up @@ -104,6 +104,11 @@
grid-row: 2;
}

> a[href*="cli-api-reference"] {
grid-column: 1;
grid-row: 3;
}

> a[href*="openapi"]:before {
content: "Supported Specs";
font-weight: 500;
Expand Down Expand Up @@ -133,21 +138,24 @@
}
}

> a[href*="cli-api-reference"] {
grid-column: 3;
grid-row: 3;
transform: translateY(-64px);

.fern-selection-item-icon {
width: 1.5rem;
height: 1.5rem;
}
}

/* > a[href*="asyncapi"]:before {
content: "Docs coming soon";
font-weight: 500;
position: absolute;
top: -1.75rem;
left: 0.5rem;
} */

> a[href*="asyncapi"] {
grid-column: 3;
grid-row: 3;
transform: translateY(-64px);
pointer-events: none;
cursor: not-allowed;

/* > div > div > div {
align-items: flex-start;
} */

.fern-selection-item-icon {
width: 1.5rem;
Expand All @@ -158,7 +166,13 @@
> a[href*="openrpc"] {
grid-column: 3;
grid-row: 4;
transform: translateY(-64px);
transform: translateY(-88px);
pointer-events: none;
cursor: not-allowed;

/* > div > div > div {
align-items: flex-start;
} */

.fern-selection-item-icon {
width: 1.5rem;
Expand All @@ -169,8 +183,14 @@
> a[href*="grpc"] {
grid-column: 3;
grid-row: 5;
transform: translateY(-64px);
transform: translateY(-88px);
pointer-events: none;
cursor: not-allowed;

/* > div > div > div {
align-items: flex-start;
} */

.fern-selection-item-icon {
width: 1.5rem;
height: 1.5rem;
Expand Down Expand Up @@ -209,18 +229,31 @@
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/product-switcher-askfern-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="cli-api-reference"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/product-switcher-cliapi-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="openapi-definition"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/openapi-definition-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="cli-api-reference"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/cli-api-reference-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="fern-definition"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/fern-definition-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="asyncapi"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/asyncapi-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="openrpc"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/openrpc-dark.png") !important;
}

:is(.dark) .fern-product-selector-radio-group a[href*="grpc"] img {
content: url("https://fern-docs.s3.us-east-2.amazonaws.com/product-switcher/grpc-dark.png") !important;
}

/*** END -- PRODUCT SELECTOR STYLING ***/

/*** START -- DOCS HOMEPAGE STYLING ***/
Expand Down
40 changes: 22 additions & 18 deletions fern/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -63,28 +63,32 @@ products:
slug: fern-definition

- display-name: CLI & API Reference
subtitle: Manage and configure your Fern projects via CLI & APIs.
path: ./products/cli-api-reference/cli-api-reference.yml
icon: fa-regular fa-terminal
image: ./images/product-switcher/cli-api-reference-light.png
image: ./images/product-switcher/product-switcher-cliapi-light.png
slug: cli-api-reference

- display-name: AsyncAPI
subtitle: Docs coming soon
path: ./products/asyncapi-def/asyncapi-def.yml
icon: fa-regular fa-bolt
image: ./images/product-switcher/asyncapi-light.png
slug: asyncapi

# - display-name: AsyncAPI
# path: ./products/asyncapi-def/asyncapi-def.yml
# icon: fa-regular fa-bolt
# image: ./images/product-switcher/asyncapi-def.png
# slug: asyncapi

# - display-name: OpenRPC
# path: ./products/openrpc-def/openrpc-def.yml
# icon: fa-regular fa-code
# image: ./images/product-switcher/openrpc-def.png
# slug: openrpc
- display-name: OpenRPC
subtitle: Docs coming soon
path: ./products/openrpc-def/openrpc-def.yml
icon: fa-regular fa-code
image: ./images/product-switcher/openrpc-light.png
slug: openrpc

# - display-name: gRPC
# path: ./products/grpc-def/grpc-def.yml
# icon: fa-regular fa-plug
# image: ./images/product-switcher/grpc-def.png
# slug: grpc
- display-name: gRPC
subtitle: Docs coming soon
path: ./products/grpc-def/grpc-def.yml
icon: fa-regular fa-plug
image: ./images/product-switcher/grpc-light.png
slug: grpc


css: ./assets/styles.css
Expand Down Expand Up @@ -470,7 +474,7 @@ redirects:
destination: /learn/openapi-definition/extensions/:slug*
permanent: true
- source: /learn/api-definition/openapi/frameworks/:slug*
destination: /learn/openapi-definition/server-frameworks/:slug*
destination: /learn/openapi-definition/frameworks/:slug*
permanent: true
- source: /learn/api-definition/openapi/:slug*
destination: /learn/openapi-definition/:slug*
Expand Down
Binary file added fern/images/product-switcher/asyncapi-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/images/product-switcher/asyncapi-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/images/product-switcher/grpc-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/images/product-switcher/grpc-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/images/product-switcher/openrpc-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added fern/images/product-switcher/openrpc-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
92 changes: 35 additions & 57 deletions fern/products/asyncapi-def/asyncapi-def.yml
Original file line number Diff line number Diff line change
@@ -1,61 +1,39 @@
navigation:
- section: Getting Started
- page: Overview
path: ./pages/overview.mdx
- page: Authentication
path: ./pages/auth.mdx
- page: Servers
path: ./pages/servers.mdx
- section: Channels
slug: channels
contents:
- page: Overview
path: ./pages/getting-started/overview.mdx
- page: Get to OpenAPI
path: ./pages/getting-started/get-to-openapi.mdx
- page: Philosophy
path: ./pages/getting-started/philosophy.mdx
- page: Customer Showcase
path: ./pages/getting-started/customer-showcase.mdx
- section: Get to OpenAPI
contents:
- page: Handwrite it
path: ./pages/getting-started/get-to-openapi/handwrite-it.mdx
- section: Generate it
contents:
- page: FastAPI
path: ./pages/getting-started/get-to-openapi/generate-it/fastapi.mdx
- page: NestJS
path: ./pages/getting-started/get-to-openapi/generate-it/nestjs.mdx
- page: Swaggo
path: ./pages/getting-started/get-to-openapi/generate-it/swaggo.mdx
- page: Request a new framework
path: ./pages/getting-started/get-to-openapi/generate-it/request-new-framework.mdx
- page: Overlay customizations
path: ./pages/getting-started/overlay-customizations.mdx
- section: Security Schemes
- page: Publish/Subscribe Operations
path: ./pages/channels/pubsub.mdx
slug: pubsub
- page: Message Formats
path: ./pages/channels/messages.mdx
slug: messages
- page: Message Bindings
path: ./pages/channels/bindings.mdx
slug: bindings
- section: Extensions
slug: extensions
contents:
- page: Overview
path: ./pages/security-schemes/overview.mdx
- page: Overriding the security scheme
path: ./pages/security-schemes/overriding-security-scheme.mdx
- page: Multiple security schemes
path: ./pages/security-schemes/multiple-security-schemes.mdx
- section: Servers
- page: Audiences
path: ./pages/extensions/audiences.mdx
- page: SDK Method Names
path: ./pages/extensions/method-names.mdx
slug: method-names
- page: Parameter Names
path: ./pages/extensions/parameter-names.mdx
- page: Other
path: ./pages/extensions/others.mdx
slug: others
- section: Workflow & Automation
skip-slug: true
contents:
- page: Overview
path: ./pages/servers/overview.mdx
- page: Overriding the servers
path: ./pages/servers/overriding-servers.mdx
- page: Naming your servers
path: ./pages/servers/naming-your-servers.mdx
- page: Multiple server URLs
path: ./pages/servers/multiple-server-urls.mdx
- section: Schemas
contents:
- page: Objects
path: ./pages/schemas/objects.mdx
- page: AllOf
path: ./pages/schemas/allof.mdx
- page: OneOf
path: ./pages/schemas/oneof.mdx
- page: AnyOf
path: ./pages/schemas/anyof.mdx
- page: Enums
path: ./pages/schemas/enums.mdx
- page: Override the type
path: ./pages/schemas/override-type.mdx
- page: Inlined schemas
path: ./pages/schemas/inlined-schemas.mdx
- page: Overlay Customizations
path: ./pages/overrides.mdx
- page: Sync your AsyncAPI Specification
path: ./pages/automation.mdx
Loading