Files
SecurityArc/docs/README.md
2025-12-11 12:31:09 +01:00

2.4 KiB

SecureArc Documentation

Welcome to the SecureArc documentation! This directory contains comprehensive documentation for users, developers, and contributors.

Documentation Index

For Users

  • User Guide - Complete end-user documentation covering GUI and CLI usage, best practices, and troubleshooting
  • Installation Guide - Step-by-step installation instructions for all platforms
  • CLI Reference - Complete command-line interface documentation with examples

For Developers

  • API Reference - Library API documentation for integrating SecureArc into applications
  • Format Specification - Technical specification of the SecureArc file format
  • Security Model - Security analysis, threat model, and cryptographic details
  • Testing Guide - Testing instructions and examples for developers

Documentation Structure

docs/
├── README.md              # This file - documentation index
├── USER_GUIDE.md          # End-user documentation
├── INSTALLATION.md        # Installation instructions
├── CLI_REFERENCE.md       # CLI command reference
├── api-reference.md       # Library API documentation
├── format-spec.md         # File format specification
├── security-model.md      # Security analysis
└── testing-guide.md       # Testing guide

Contributing to Documentation

When updating documentation:

  1. Keep examples up-to-date with the latest code
  2. Test all code examples before committing
  3. Use proper Markdown formatting for GitHub
  4. Add cross-references between related documents
  5. Update this index if adding new documentation files

Questions?

If you have questions or find issues with the documentation:

  1. Check the relevant guide above
  2. Review the User Guide for common questions
  3. Check the Security Model for security-related questions
  4. Open an issue on GitHub for documentation improvements