Apache Asyncband (Incubating) Website

Clone this repo:

Branches

  1. 9e17c31 chore: Fix formatting in .asf.yaml configuration by tison · 3 days ago main
  2. 0daf85c feat: lead the homepage with its async Rust positioning (#15) by tison · 3 days ago
  3. e34caf4 chore: format Markdown with dprint (#14) by tison · 3 days ago
  4. b36508a docs: add Apache Asyncband 0.7.2 downloads (#13) by tison · 3 days ago
  5. 32a0633 docs: sync API map categories (#12) by tison · 10 days ago

Apache Asyncband (Incubating) Website

This repository contains the source for the Apache Asyncband (Incubating) website. Read the project DISCLAIMER and learn what incubation means.

Developing

Install dependencies and start the Docusaurus development server:

pnpm install
pnpm dev

The local site is available at http://localhost:3000/ by default.

Writing documentation

Pages live under src/pages/. The homepage is src/pages/index.tsx, with its prose content in src/pages/_home-content.md. Markdown pages start with frontmatter for their title and metadata; the rest of the file is Markdown.

Fenced bash and rust code blocks are highlighted during the build. Docusaurus also supports MDX components when a page needs behavior beyond Markdown.

Run pnpm format to format the repository.

Validating

Run the type, formatting, lint, and production-build checks:

pnpm validate

Building and previewing

Generate the static site and preview the result locally:

pnpm build
pnpm preview

The generated site is written to build/. Pushing to main builds and publishes the site through the asf-site branch.

To publish a staging preview, push the site source to a branch named preview/<name>. The same deployment workflow publishes the build through site/<name>-staging, which ASF serves at https://asyncband-<name>.staged.apache.org/.

License

Licensed under the Apache License, Version 2.0.