Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fill in the technical documentation #605

Open
3 tasks
vikman90 opened this issue Feb 14, 2025 · 1 comment · May be fixed by #613
Open
3 tasks

Fill in the technical documentation #605

vikman90 opened this issue Feb 14, 2025 · 1 comment · May be fixed by #613
Assignees
Labels

Comments

@vikman90
Copy link
Member

vikman90 commented Feb 14, 2025

Description

We need to complete the technical documentation of the project following the Diátaxis framework. This includes development documentation and a comprehensive reference manual.

Expected documentation

dev/ (Development documentation)

  • Setting up the development environment
    • Setting up the toolchain
    • Setting up the editor/debugger
  • How to generate a package
  • How to generate a container image
  • How to build from sources
    • Build scripts/Makefiles
  • How to run the product from source for testing/development
  • How to run the tests

ref/ (Reference manual)

  • Introduction
    • Description
    • Architecture
    • Compatibility
  • Getting started
    • Requirements
    • Packages
    • Installation
  • Configuration
    • Environment variables
    • Command line options
    • Configuration files
  • Modules (for each module)
    • Description
    • Architecture
    • API reference
  • Upgrade
  • Uninstall
  • Back up and restore
  • Security
  • Performance
  • Glossary

Definition of Done

  • All documentation points are written
  • The documentation follows the Diátaxis framework
  • The structure is consistent and clear

Additional Notes

  • Ensure technical accuracy and completeness
  • Maintain a professional and concise writing style
  • Use Markdown formatting for clarity
@sdvendramini
Copy link
Member

2025/02/17

I started working on the issue by studying Diátaxis. Then, I reviewed the existing documentation and began reorganizing it.

@sdvendramini sdvendramini linked a pull request Feb 18, 2025 that will close this issue
8 tasks
@sdvendramini sdvendramini linked a pull request Feb 18, 2025 that will close this issue
8 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: In progress
Development

Successfully merging a pull request may close this issue.

3 participants