Skip to content

Latest commit

 

History

History
46 lines (28 loc) · 1.8 KB

readme.md

File metadata and controls

46 lines (28 loc) · 1.8 KB

Docs site for the OpenJS Architect framework!

GitHub CI status

Docs Development

ℹ️ We're actively improving Architect documentation, this repository, and this readme

This docs site is its own Architect project 🎉 so it can be run locally with npx arc sandbox

Table of Contents & Sidebar

The Sidebar is dynamically built from table-of-contents.js and the current state.

The Table of Contents (TOC) is a simple set of objects containing arrays of strings that correspond with Markdown documents.

⚠️ The fourth level of items will be grouped into a (closed by default) collapsible group. Use sparingly!

Markdown & Frontmatter

All docs are written in Markdown.

The renderer combines markdown-it and frontmatter to create HTML views.

The frontmatter attributes are technically optional but highly encouraged as they aid the site's SEO.

attribute type effect
title string HTML title
category string HTML title prefix
description string HTML meta description
sections string[] currently unused

Todo

  • dynamic category landing page
  • writing style guide
  • a homepage
  • dark mode

Contributing

Find out more about contributing to Architect