# Terminología Estandarizada

Este documento proporciona una referencia para la terminología preferida a utilizar al discutir las características y conceptos de Rememberizer. Seguir estos estándares ayuda a mantener la consistencia en la documentación.

## Términos y Definiciones Preferidos

| Término Preferido      | Términos Alternativos               | Definición                                                                                                                                                                                                                             |
| ---------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Almacén de Vectores    | Base de Datos de Vectores           | El término preferido para la implementación de la base de datos de vectores de Rememberizer es "Almacén de Vectores." Aunque "Base de Datos de Vectores" es técnicamente preciso, se debe usar "Almacén de Vectores" por consistencia. |
| Embeddings de Vectores | Embeddings                          | El término completo "Embeddings de Vectores" es preferido en contenido educativo, mientras que "Embeddings" es aceptable en contextos técnicos y ejemplos de código.                                                                   |
| Fuente de Datos        | Fuente de Conocimiento, Integración | "Fuente de Datos" es el término preferido para referirse a los orígenes de los datos (Slack, Google Drive, etc.).                                                                                                                      |
| Conocimiento Común     | Conocimiento Compartido             | Use "Conocimiento Común" al referirse a la función que permite compartir conocimiento con otros usuarios y aplicaciones.                                                                                                               |
| Memento                | Filtro de Memento                   | Use "Memento" como el término principal, aunque "Filtro de Memento" es aceptable en contextos de UI.                                                                                                                                   |
| Integración de Memoria | Memoria Compartida, Memoria         | "Integración de Memoria" es el nombre completo preferido de la función; "Memoria Compartida" es aceptable en contenido dirigido al usuario.                                                                                            |
| Autenticación OAuth2   | OAuth                               | Use el término completo "Autenticación OAuth2" en documentación formal, aunque "OAuth" es aceptable en contextos menos formales.                                                                                                       |
| Busca Tu Conocimiento  | Buscar en Rememberizer              | "Busca Tu Conocimiento" debe usarse al referirse al nombre de la función en títulos y navegación.                                                                                                                                      |
| Memorizar              | Almacenar                           | Use "Memorizar" para el punto final de la API y el nombre de la funcionalidad, mientras que "Almacenar" puede usarse en contextos explicativos.                                                                                        |
| X-API-Key              | x-api-key                           | Use "X-API-Key" en mayúsculas en la documentación, aunque la minúscula es aceptable en ejemplos de código.                                                                                                                             |

## Convenciones de API

### Directorio de Documentación de la API

La ruta oficial de la documentación de la API es `/en/developer/api-docs/`. La ruta heredada `/en/developer/api-documentations/` debe ser eliminada gradualmente.

### Encabezados de API

Las siguientes convenciones de encabezado deben utilizarse de manera consistente:

* **Encabezado de Autorización**: `Authorization: Bearer YOUR_JWT_TOKEN`
* **Encabezado de Clave de API**: `X-API-Key: YOUR_API_KEY`
* **Encabezado de Tipo de Contenido**: `Content-Type: application/json`

### Estilo de Puntos de Acceso de API

Los puntos de acceso de API deben estar estilizados de manera consistente:

* URL base: `https://api.rememberizer.ai/api/v1/`
* Rutas de puntos de acceso en minúsculas con guiones según sea necesario: `/documents/search/`
* Rutas de almacenamiento de vectores con marcador de posición de parámetro: `/vector-stores/{vector_store_id}/documents/search`

## Convenciones de Nombres de Características

### Nombres de Integración

Los nombres de integración deben seguir el patrón:

* Integración de Rememberizer {Nombre de Integración} (por ejemplo, "Integración de Rememberizer Slack")

### Nomenclatura del Servidor MCP

Los tipos de servidores MCP deben ser claramente distinguidos:

* **Servidor MCP de Rememberizer**: Servidor de propósito general
* **Servidor MCP de Almacenamiento de Vectores de Rememberizer**: Servidor específicamente para operaciones de almacenamiento de vectores

## Convenciones de Títulos de Documentos

Los títulos de los documentos deben seguir estas convenciones:

* Capitalizar palabras importantes (Título en Mayúsculas)
* Usar terminología consistente para las características
* Evitar acrónimos en los títulos a menos que sean ampliamente reconocidos (por ejemplo, API)
* Mantener los títulos concisos y descriptivos

## Uso de Esta Guía

Al crear o actualizar documentación, consulte esta guía para garantizar una terminología consistente. Al encontrar términos variantes en la documentación, priorice la actualización a los términos preferidos que se enumeran aquí al realizar otros cambios en esos documentos.

Recuerde que mantener la integridad de los enlaces y los nombres de los archivos es crucial, así que concéntrese en actualizar la terminología dentro del texto mientras preserva las URL y las estructuras de archivos.
