API Mesh for Adobe Developer App Builder Documentation

This repository is used to store the code for the API Mesh for Adobe Developer App Builder documentation website. It is built using the Adobe Edge Delivery Services and deployed to Adobe Developer.

This site contains the latest API Mesh for Adobe Developer App Builder documentation for ongoing releases.

Contributors

Our goal is to provide the Adobe Developer community with comprehensive and quality technical documentation. We believe that to accomplish that goal we need experts from the community to share their knowledge with us and each other. We are thankful to all of our contributors for improving the documentation.

See the Contribution Guide for details about contributing to Adobe Developer documentation.

Quick start

For local development, you need to start three servers:

1. Content server (your content repo):

   npm run dev

   This starts the content server on port 3003.

2. Code server (adp-devsite):

   git clone https://github.com/AdobeDocs/adp-devsite
   cd adp-devsite
   npm install
   npm run dev

3. Runtime connector (devsite-runtime-connector):

   git clone https://github.com/aemsites/devsite-runtime-connector
   cd devsite-runtime-connector
   npm install
   npm run dev

Once all three servers are running, navigate to http://localhost:3000/graphql-mesh-gateway/

For common utilities and documentation, please see the centralized README.

Testing and linting

Markdown linting

To lint your markdown files before pushing, execute:

npm run lint:md

To automatically fix linting errors, execute:

npm run lint:md:fix

Content validation

To check internal and external links, validate front matter and more, execute:

npm run lint

TOC validation

To validate the table of contents (TOC) file, execute:

npm run test:config

Comment blocks

HTML comment blocks (\<!-- ... --\>) in .md files under src/pages/ document either disabled features or currently unsupported scenarios. They are intentionally left in place for reference and possible future implementation.

If you have questions, open an issue and ask us. We look forward to hearing from you!