📖 Welcome to Concerto Documentation repository

This is the home of the Concerto documentation repository! Here, we aim to help our users make the best of Data Protocols — Custom and verifiable data-driven digital asset management.

For more information about Concerto, our open-source code and technical details, please visit the Concerto Organization Profile. You will find some Concerto related repositories, along with other resources from Concerto.

This website is built using Docusaurus 2, a static website generator.

Get started

Installation

$ pnpm install

Local Development

$ pnpm start

This command starts a local development server and opens a browser window. Most changes are reflected live without having to restart the server.

Customization

Creating and organizing content

• Store content in the docs directory, supporting .md and .mdx files. Learn more →
• Configure each folder metadata accordingly, using_category_.json or _category_.yml. Learn more →
• Utilize frontmatter options for configuration and customization. See the API here →
• Set a specific page as the main page [link] (if you do not intend to create a dedicated homepage. Otherwise, to create a homepage learn more here)
• Configure header navigation items in the docusaurus.config.js file. Learn more →
• Create multiple sidebars by updating sidebars.js according to your docs folder structure. Learn more →

Example of a tree structure in the docs folder:

docs
├── getting-started
│   ├── introduction.md
│   └── installation.md
└── guides
    ├── configuration.md
    └── customization.md

Using the autogenerated sidebar:

module.exports = {
  sidebars: {
    gettingStarted: [
      {
        type: 'autogenerated',
        dirName: 'getting-started',
      },
    ],
    guides: [
      {
        type: 'autogenerated',
        dirName: 'guides',
      },
    ],
  },
};

This will generate separate sidebars for the getting-started and guides folders. Adjust the header navigation items in docusaurus.config.js accordingly.

Ensure you update both the sidebars.js file and the header navigation items in docusaurus.config.js when changing the documentation structure, providing a seamless navigation experience for users.

Customization

Basic customization

• Change fonts following instructions at tailwind.config.ts
• Modify typography settings at tailwind.config.ts
• Update colors at tailwind.config.ts

Advanced customization

• Apply component-specific styles at specific module.css files
• Use mdx and React. Learn more →
• Swizzle built-in components or update our modifications at src/theme/* files. Learn more about Swizzling →
• Develop custom React pages at src/pages. Learn more →

Best practices

• When swizzling components, add comments to indicate where changes occurred
• Follow Docusaurus-specific best practices for versioning and customization. Learn more →

Deployment

Build

$ pnpm build

This command generates static content into the build directory and can be served using any static contents hosting service.

Documentation deployment guidelines

To deploy your documentation with Vercel, follow these steps:

1. Sign up for a Vercel account if you don't have one.
2. Install the Vercel CLI by running npm i -g vercel.
3. Run vercel login in your terminal and log in using your Vercel account.
4. In your project directory, run vercel to initiate the deployment process. Follow the prompts to link your project to Vercel.
5. Once your project is linked, Vercel will deploy your documentation. After the deployment, you'll receive a URL to access your live documentation.

For subsequent deployments, run vercel --prod in your project directory to deploy your documentation to the production environment.

For more information on Vercel deployments, consult the official Vercel documentation.

Contributing to this documentation

We welcome contributions to improve and expand the documentation for Concerto. Here's how you can contribute:

1. Report issues: If you find any errors, inconsistencies, or areas that need improvement, please open an issue on the GitHub repository. Provide a clear description of the issue and suggest a possible solution or improvement.
2. Suggest enhancements: If you have ideas for new sections, topics, or content that would be helpful to others, please share your suggestions by opening an issue on the GitHub repository.
3. Submit a pull request: If you'd like to contribute directly by fixing an issue or adding new content, please fork the repository, make changes, and submit a pull request. Ensure your changes follow the documentation guidelines and best practices outlined in the README.

Note: If you want to contribute to some of Concerto technologies source code, please visit the repository at Concerto Organization profile and follow the contribution guidelines.