Skip to content

axelarnetwork/axelar-docs

Repository files navigation

Axelar Docs

The official documentation website for Axelar.

The project uses Astro and deploys via Vercel. To develop it locally, clone this repository and run the following command to start the local dev server:

npm install
npm run dev

And visit localhost:3000 to preview your changes.

Updating Navigation

Site navigation is generated in TypeScript based on the section the user is currently browsing in. The navigation layout is managed in src/layouts/navigation.ts, with pages represented as a title and href in one of the children arrays. The site supports up to 3 levels of nested navigation, with the top level acting as navigation header. Each subsequent level is visually tabbed beneath its parent.

How to Contribute to the Docs

Here's what you need to know to contribute to the Axelar documentation:

  • Content Folder: Contributions are made by adding files to this folder. This folder structure defines the organization and links within the documentation.
  • Creating a New Page: To add a new page, create a new Markdown file (.md or .mdx) inside the /docs/ folder. Use a descriptive filename that reflects the topic of your page (e.g., /src/content/docs/learn/security.mdx).
  • Updating Navigation: Once you've created a new page, you need to update the navigation bar to include it. Edit the file src/layouts/navigation.ts. This file controls the navigation links throughout the Axelar docs website. Locate the appropriate section and add an entry for your new page, ensuring consistency with the existing navigation style.

Short links

These links redirect to pages in the documentation whose slugs may otherwise be hard to remember.

ITS