markoburcul 640798f1ad
build: add jenkinsfile and flake file
To be able to deploy site we need a pipeline to build it and publish it
to a branch from which our caddy-git service will pull for changes.
All of this will be done using nix flake to ease out the
build/development process.

Referenced issue: https://github.com/status-im/status-network-docs/issues/1

Signed-off-by: markoburcul <marko@status.im>
2024-10-28 13:56:19 +01:00
2024-10-24 21:09:46 +05:30
2024-10-24 21:09:46 +05:30
2024-10-24 21:09:46 +05:30
2024-10-24 22:05:17 +05:30
2024-10-24 21:09:46 +05:30
2024-10-24 21:09:46 +05:30
2024-10-24 21:09:46 +05:30
2024-10-24 22:05:17 +05:30

Status Network Documentation

Welcome to the official documentation for Status Network! This repository contains the source code for our documentation website, built using Docusaurus, a modern static website generator.

🚀 Getting Started

Prerequisites

If you are familiar with using Nix shell all of the dependencies will be installed by just running nix develop from within this repository which will spawn a new shell.

Installation

# Clone the repository
git clone https://github.com/status-network/docs.git
cd docs

# Install dependencies
yarn

Local Development

# Start the development server
yarn start

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

Build

# Build the static site
yarn build

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

CI/CD

The hosting is done using Caddy server with Git plugin for handling GitHub webhooks.

Information about deployed build can be also found in /build.json available on the website.

📝 Contributing

We welcome contributions from the community! Here's how you can help improve our documentation:

Making Changes

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/your-feature-name
  3. Make your changes
  4. Test locally using yarn start
  5. Commit your changes: git commit -am 'Add some feature'
  6. Push to the branch: git push origin feature/your-feature-name
  7. Submit a pull request

Documentation Structure

docs/
├── introduction/         # Introduction and getting started
├── tokenomics/          # SNT and AURA token documentation
├── general-info/        # Network details and contracts
├── tools/              # Development tools and resources
├── tutorials/          # Step-by-step guides
├── security/           # Security information
└── other/              # Additional resources

Style Guide

When contributing to the documentation, please follow these guidelines:

  • Use clear, concise language
  • Include code examples where applicable
  • Add screenshots or diagrams for complex concepts
  • Follow the existing document structure
  • Use appropriate frontmatter for all markdown files

Example markdown frontmatter:

---
id: page-id
title: Page Title
description: Brief description of the page
sidebar_position: 1
---

Made with ❤️ by the Status Network community

Description
Documentation site for Status Network
https://docs.status.network
Readme
Languages
TypeScript 44%
CSS 43.9%
Shell 8%
Nix 3.7%
JavaScript 0.4%