Documentación de Joss

Esta documentación describe el comportamiento del código actual. Está separada en aprendizaje, guías, referencia e internos para que una persona nueva pueda avanzar en orden y una persona experimentada encuentre reglas concretas.

Idiomas

• Español (fuente canónica): este directorio.
• English
• Português

Los 46 documentos mantienen el mismo nombre en cada idioma para que los enlaces relativos funcionen igual. Después de editar el español, ejecuta go run ./tools/docsi18n -translate -sync para actualizar traducciones y espejo web; go run ./tools/docsi18n -check detecta archivos ausentes, traducciones desactualizadas, enlaces rotos o diferencias con JosSecurity.

Aprender Joss (Ruta guiada para principiantes)

Si nunca has programado o estás aprendiendo Joss por primera vez, lee este recorrido en orden. Cada página introduce los conceptos con explicaciones pedagógicas, ejemplos visuales paso a paso y chuletas rápidas antes de profundizar en los aspectos técnicos avanzados.

1. Primeros pasos: de un archivo a tu primer programa interactivo con cin
2. Valores, variables y operaciones fundamentales
3. Control de flujo y toma de decisiones
4. Funciones, scope, closures y referencias
5. Arrays, maps y texto
6. Tipos, inferencia y conversiones
7. Clases, objetos y herencia
8. Errores y excepciones
9. Async, Future, channels y concurrencia
10. Proyecto de consola completo con persistencia JSON
11. Proyecto web completo con MVC nativo

El glosario explica términos de programación y de Joss sin exigir que ya conozcas otro lenguaje.

Referencia del lenguaje y herramientas

• Sintaxis, tokens y precedencia
• Gramática EBNF y nodos AST
• Funciones, recursión y tipos
• Diagnósticos y analizador
• Funciones globales
• Clases nativas y servicios
• Catálogo nativo generado
• CLI, formatter, linter y tests
• Soporte móvil: Android e iOS
• Extensión de VS Code
• Estado y límites

Crear aplicaciones

• Estructura de proyectos y configuración
• Organización sin imports y plugins
• Web: servidor, HTTP/controladores, middleware, vistas, assets y WebSockets
• Datos: modelos/GranDB, Schema Builder y migraciones
• Aplicación: autenticación y SEO/sitemap

Internos y mantenimiento

• Arquitectura del lenguaje
• Guía de contribución
• Auditoría de documentación
• Auditoría del lenguaje Joss 2026
• Auditoría del ORM GranDB 2026
• Auditoría técnica de 2026
• Auditoría de optimización runtime
• Novedades históricas 3.6.7

Los documentos históricos conservan contexto y pueden describir el estado de su fecha. Ante una diferencia mandan la implementación, las pruebas y Estado de implementación.