Merge pull request #54 from LibreSign/chore/change-introduction-text

Any97Cris · web-flow · commit 00a981a95239 · 2025-07-15T13:32:24.000-04:00
change introduction text
diff --git a/admin_manual/index.rst b/admin_manual/index.rst
@@ -1,5 +1,5 @@
 Admin Manual
-=================
+============
 
 Welcome to the user manual for the software. This documentation is designed to help you understand how to use the software effectively.
 
diff --git a/admin_manual/introduction.rst b/admin_manual/introduction.rst
@@ -6,14 +6,27 @@ What is Libresign?
 
 Libresign is a software package that provides a set of tools for working with digital signatures. It is designed to be easy to use and flexible, allowing you to integrate it into your own applications or use it as a standalone tool.
 
-Videos and blogs
-----------------
+About This Documentation
+------------------------
 
-Visit our `blog <https://libresign.coop/posts/>`__
+This section is intended for LibreSign system administrators, who are responsible for installing, configuring, maintaining, and monitoring the application in test or production environments.
+
+Here you will find:
+
+ - System requirements and installation instructions;
+
+ - Environment configuration, variables, and required services (e.g., database, containers, certificates);
+
+ - User and permission management;
 
-Target audience
----------------
+ - Backup, update, and recovery procedures;
 
-- Public sector
-- Education
-- Private companies
+ - Best practices for security and system monitoring.
+
+This documentation was designed to support those who ensure that LibreSign runs securely and efficiently.
+
+
+Blog
+----
+
+Visit our `blog <https://libresign.coop/posts/>`__
diff --git a/developer_manual/index.rst b/developer_manual/index.rst
@@ -16,8 +16,10 @@ Here you will find the documentation for developers.
 
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
+   :hidden:
 
+   introduction
    guide-api
    api
    code-of-conduct
diff --git a/developer_manual/introduction.rst b/developer_manual/introduction.rst
@@ -0,0 +1,31 @@
+Introduction
+============
+
+What is Libresign?
+------------------
+
+Libresign is a software package that provides a set of tools for working with digital signatures. It is designed to be easy to use and flexible, allowing you to integrate it into your own applications or use it as a standalone tool.
+
+About This Documentation
+------------------------
+
+This section is intended for developers who want to understand the architecture of LibreSign, contribute to the codebase, or integrate the solution with other systems.
+
+Here you will find:
+
+ - An overview of the project's architecture and core technologies;
+
+ - Instructions for setting up the development environment;
+
+ - Code standards, folder structure, and best practices adopted in the project;
+
+ - Detailed API documentation and usage examples;
+
+Guidelines for contributing to the source code and submitting improvements.
+
+Whether you're part of the team, an external contributor, or simply curious about how LibreSign works under the hood — this section is for you.
+
+Blog
+----
+
+Visit our `blog <https://libresign.coop/posts/>`__
diff --git a/main/index.rst b/main/index.rst
@@ -3,14 +3,16 @@
 Welcome to LibreSign documentation
 ==================================
 
-Chose one of the sections below to access the corresponding documentation:
+Welcome to the LibreSign documentation — a digital signature solution developed entirely with free and open-source software by a technology cooperative. This project aims to provide a secure, accessible, and transparent platform for digital document authentication and validation.
 
-- `User manual </user_manual/>`_
-- `Developer manual </developer_manual/>`_
-- `Admin manual </admin_manual/>`_
+This documentation is organized into sections tailored for different audiences:
+
+- `User manual </user_manual/>`_ : instructions on how to use the system.
+- `Developer manual </developer_manual/>`_ : technical guides, APIs, and contribution guidelines.
+- `Admin manual </admin_manual/>`_ : guidance for installing, configuring, and maintaining the platform.
 
 
 Reporting Documentation Bugs & How to Contribute
-=================================================
+================================================
 
 If you find an error or omission in any of the manuals, we welcome your bug reports and contributions. Contribution to the documentation is very easy as the code is entirely `on GitHub and can be edited there online <https://github.com/LibreSign/documentation/>`_.
diff --git a/user_manual/introduction.rst b/user_manual/introduction.rst
@@ -6,9 +6,28 @@ What is Libresign?
 
 Libresign is a software package that provides a set of tools for working with digital signatures. It is designed to be easy to use and flexible, allowing you to integrate it into your own applications or use it as a standalone tool.
 
+About This Documentation
+------------------------
+
+This section is intended for LibreSign users — individuals who need to sign, validate, or track digital documents in a simple and secure way.
+
+Here you will find:
+
+ - Step-by-step guides on how to use the main features of the system;
+ - Explanations of the user interface, including screens and menu options;
+ - Instructions for performing digital signatures, viewing documents, and tracking process status;
+ - Tips and answers to frequently asked questions (FAQ).
+
+No technical knowledge is required to use the system. This documentation was designed to be clear and accessible, even for those without a technology background.
+
 Target audience
 ---------------
 
 - Public sector
 - Education
 - Private companies
+
+Blog
+----
+
+Visit our `blog <https://libresign.coop/posts/>`__
