Docs

screenshot of Docs
mkdocs

TomoChain documentation

Overview

TomoChain offers a robust and user-friendly framework for developers looking to contribute to blockchain documentation. The platform's design focuses on collaboration and efficiency, making it easier for contributors to deliver clear and precise content. With the aid of Python and virtual environments, contributors can effectively manage their dependencies and make changes in a live setting, streamlining the documentation process.

Features

  • Virtual Environment Setup: Easily create and manage virtual environments for project dependencies, ensuring a clean workspace for contributions.

  • Live Editing: Test changes in real-time by running a local server, allowing users to see their edits immediately at localhost:3000.

  • Branching Guidelines: Clear instructions for branching during contributions help maintain organization, with a straightforward naming convention for issue-related branches.

  • Commit Structure: Promotes best practices in version control by guiding contributors to start commit messages with a verb, enhancing the clarity of each update.

  • Markdown Formatting: The documentation encourages contributors to write one sentence per line in Markdown, which aids in maintaining clear git diffs and better readability.

  • Contribution Clarity: A well-defined contribution guideline provides new developers with the resources and knowledge they need to effectively engage with the project.

This structured approach not only fosters collaboration but also enhances the overall quality and consistency of the documentation process, making it an enjoyable experience for contributors.

mkdocs
MkDocs

MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file.

documentation
Documentation

Documentation themes are built specifically for writing technical and product documentation. They are normally written and maintained in Markdown. The often include a navigation menu, search bar, clear headings, semantic document structure and clean typography.