Please review the guidelines mentioned throughout this document, and when ready, you can open a PR against the
main branch. Typically from there, someone from the Tanssi Developer Relations team will review the PR and request any changes as needed. Then the team will merge your PR into a local branch and make sure that all of the formatting changes look good on the local site. Once everything is all set and done the changes will be published to the live site.
Thank you for your contributions, they are greatly appreciated 💜.
Previewing Changes in VS Code¶
Unfortunately, there is not currrently a way to review the changes locally. However, if you're using Visual Studio Code, you can preview the changes you're making to
.md files before committing them. To learn how, please check out the Markdown and Visual Studio Code guide from the Visual Studio docs site.
In the root directory and every subdirectory, in addition to the content directories and pages, you'll find the following files:
.pages- defines the structure of the documentation site
index.md- represents the landing pages you see throughout the docs site
Below is an example of a
Some important things to note:
titlefield at the top of the page represents the display name for the subdirectory
index.mdpage should always be the first item in the list
- Files follow the convention of 'Display Name': 'file-name.md'
- Subdirectories are listed by their directory name in the source code
Below is an example of an
title: Build your ContainerChain
description: Install the software to compile your ContainerChain, configure your genesis state and core functionalities, test locally and get ready to deploy through Tanssi.
Some important things to note:
<title>tag and is used for SEO purposes
descriptionrepresents the meta-description and is also used for SEO purposes
templatedefines the template to be used. It should always be
main.htmlfor new content pages and
subsection-index-page.htmlwhen adding a new section
<div>is populated with links to any pages or subdirectories and is populated automatically by a script at runtime that builds the landing pages
When adding a new content page, you should have the following components:
title- represents the
<title>tag and is used for SEO purposes (not displayed on the published site)
description- represents the meta-description and is also used for SEO purposes (not displayed on the published site)
- Page title - a title to be displayed at the top of the page
## Introductionsection - 2-3 paragraphs to serve as an introduction. This should be long-lived, meaning it will not require changes in the future
Optionally, you should also consider including the following sections:
## Checking Prerequisitessection - if the guide requires the user to have certain developer tools installed, for example Docker or MetaMask, it should be listed here
## Getting Startedsection - if this is a 3rd party integration, having links that point to the most important parts of your project's documentation site that helps users to get started with your project
title: Title for SEO purposes
description: Description for SEO purposes.
# Page Title
Write 2-3 paragraphs to serve as the introduction here.
Images and Icons¶
Images are stored in the
images subdirectory. They are organized to mirror the structure of the docs site. So, for example, if you are creating a new page for the
builders section and need to add images, those would go under the
All landing pages require a logo or relevant icon. You can use the
_index-page-icon-template.svg that is in the root of the
images subdirectory to create your own that is the correct size. Images should follow these specs:
- Have a transparent background
- Be 256x256px in size
- Be added in
- When exporting the SVG to a PNG, please use a DPI of
- The colors should be:
- Light mode: #262626
- Dark mode: #e9e9e9
These images are stored in the
To add an image to your page, you should have alt text and use the following syntax:
![Alt text goes here](/images/<subdirectory>/<image-file-name>.webp)
Snippets can be used to manage reusable lines of code or text. There is a subdirectory for
text snippets will get translated for the Chinese version of the documentation site. On the other hand, the
code snippets should only contain code and therefore do not get translated.
To link to a snippet, you can use the following syntax in the Markdown file:
Code snippets can be written in Markdown or the programming language itself, for example,
.py for Python,
Search Enging Optimization (SEO)¶
Here are some resources to help you create good titles and descriptions for SEO:
In general, titles should be between 50 and 60 characters and descriptions should be between 110 and 160 characters.
| Created: September 8, 2023