Skip to content

Documentation Structure

This page provides an overview of the faneX-ID documentation structure to help you navigate and find the information you need.

πŸ“š Documentation Overview

User Documentation

Getting Started (users/getting-started.md) - First steps with faneX-ID - Initial login and setup - Understanding the dashboard

Dashboard (users/dashboard.md) - Dashboard features - Widgets and customization - Quick actions

Security (users/security.md) - Password management - Two-factor authentication - Passkey setup

Configuration (users/configuration.md) - User settings - Preferences - Profile management

Troubleshooting (users/troubleshooting.md) - Common issues - Solutions - Getting help

IT Administrator Documentation

Introduction (it/index.md) - IT administrator overview - Responsibilities - Key concepts

Installation (it/installation.md) - System requirements - Installation steps - Initial configuration

Deployment (it/deployment.md) - Deployment options - Docker deployment - Production setup

SaaS & Hybrid Deployment (it/saas-deployment.md) - SaaS deployment models - Hybrid architecture - OnPrem connector setup - Network configuration

OnPrem Connector (it/onprem-connector.md) - Connector installation - Configuration guide - Troubleshooting

Maintenance (it/maintenance.md) - System maintenance - Updates and upgrades - Backup procedures

Security (it/security.md) - Security best practices - Hardening guidelines - Compliance

Developer Documentation

Introduction (developers/index.md) - Developer overview - Getting started - Development setup

Architecture (developers/architecture.md) - System architecture - Component overview - Design patterns

Repository Architecture (developers/repositories.md) - Repository structure - Multi-repo setup - Contribution guidelines

Integrations (developers/integrations.md) - Integration development - Integration store - Best practices

API Reference (developers/api.md) - REST API documentation - Authentication - Endpoints

CI/CD Infrastructure (developers/cicd.md) - CI/CD pipelines - Testing - Deployment automation

πŸ“ Directory Structure

docs/
β”œβ”€β”€ assets/              # Images, logos, favicons
β”œβ”€β”€ developers/          # Developer documentation
β”‚   β”œβ”€β”€ index.md
β”‚   β”œβ”€β”€ architecture.md
β”‚   β”œβ”€β”€ repositories.md
β”‚   β”œβ”€β”€ integrations.md
β”‚   β”œβ”€β”€ api.md
β”‚   └── cicd.md
β”œβ”€β”€ it/                  # IT Administrator documentation
β”‚   β”œβ”€β”€ index.md
β”‚   β”œβ”€β”€ installation.md
β”‚   β”œβ”€β”€ deployment.md
β”‚   β”œβ”€β”€ saas-deployment.md
β”‚   β”œβ”€β”€ onprem-connector.md
β”‚   β”œβ”€β”€ maintenance.md
β”‚   └── security.md
β”œβ”€β”€ users/               # User documentation
β”‚   β”œβ”€β”€ index.md
β”‚   β”œβ”€β”€ getting-started.md
β”‚   β”œβ”€β”€ dashboard.md
β”‚   β”œβ”€β”€ security.md
β”‚   β”œβ”€β”€ configuration.md
β”‚   └── troubleshooting.md
β”œβ”€β”€ downloads.md         # Download information
β”œβ”€β”€ releases.md          # Release information
β”œβ”€β”€ status.md            # System status
β”œβ”€β”€ structure.md         # This file
└── index.md             # Homepage

For End Users

Start here: 1. Getting Started - Learn the basics 2. Dashboard - Understand the interface 3. Security - Secure your account 4. Configuration - Customize settings

For IT Administrators

Start here: 1. Introduction - Understand your role 2. Installation - Install faneX-ID 3. Deployment - Deploy to production 4. SaaS & Hybrid Deployment - Set up hybrid deployments 5. Security - Secure your deployment

For Developers

Start here: 1. Introduction - Developer overview 2. Architecture - Understand the system 3. Integrations - Build integrations 4. API Reference - Use the API

Common Topics

Installation & Setup - Installation Guide - Docker Setup - OnPrem Connector

Deployment Models - On-Premises - Cloud/SaaS - Hybrid

Security - User Security - Admin Security - API Tokens

Development - Integration Development - API Documentation - Architecture

Troubleshooting - User Issues - Connector Issues - System Issues

πŸ“– Documentation Features

  • Search: Use the search bar to find specific topics
  • Navigation: Use the sidebar to browse by category
  • Code Examples: All code examples are syntax-highlighted
  • Interactive: Try the live demo links where available
  • Versioned: Documentation is versioned with releases

🀝 Contributing

Found an error or want to improve the documentation?

  1. Navigate to the page
  2. Click "Edit on GitHub" (top right)
  3. Make your changes
  4. Submit a pull request

πŸ“ž Support