Overview

Netdata Learn is an innovative documentation site developed on the Docusaurus framework. This repository serves as a mirrored code base that simplifies the management and contribution of documentation for the Netdata project. Offering a straightforward architecture, it provides users and contributors with an efficient way to access and modify documentation, promoting seamless collaboration and effective content delivery.

What stands out is the automated deployment process via Netlify, ensuring that the latest updates are live without much hassle. The infrastructure is designed in a way that it maintains the original files from the primary Netdata repositories, emphasizing the importance of following specific guidelines for contributions.

Features

Automated Deployment: Changes to documentation are deployed automatically to Netlify, ensuring that the most up-to-date content is always accessible.
Mirror Architecture: The repository's /docs folder mirrors original files from the Netdata repositories, preserving the integrity of the documentation while allowing community contributions.
Local Development Environment: Users can easily set up a local development environment to test changes and view updates in real time, making it developer-friendly.
Markdown Live Updates: Edits made to Markdown files are reflected instantly on the local server, promoting a dynamic development experience without the need for constant restarts.
Ingest Process: The manual ingest script allows users to pull documentation from multiple repositories, providing flexibility for those making changes across branches or forks.
Python Integration: The requirement for Python v3.9+ ensures that the process is compatible with modern coding practices and allows for easy management of dependencies.
Contribution Guidelines: Detailed documentation is available for contributors, including a style guide to maintain high-quality standards in submissions.
Version Control: The ability to create separate test branches allows contributors to work safely without affecting the main project until changes are finalized.