Cómo contribuir al blog

¿Quieres escribir para el blog de Solidiom? Esta guía rápida te explica cómo añadirte como autor y crear tu primera entrada.

1. Regístrate como autor

Añade una entrada en apps/site/src/data/authors.json. Cada entrada sigue este formato:

{
  "id": "tu-usuario-github",
  "name": "Tu Nombre Completo",
  "description": "Biografía corta (por ejemplo, "Colaborador principal de Solidiom")",
  "avatar": "https://github.com/tu-usuario-github.png",
  "github": "tu-usuario-github",
  "linkedin": "tu-usuario-linkedin",
  "website": "https://tu-sitio-web.com"
}

Nota:id debe ser único y se utiliza para hacer referencia a ti en los artículos. Los camposlinkedin y website son opcionales.

2. Crea tu entrada

Todas las entradas se escriben en Markdown. Añade tu archivo en apps/site/src/content/es/articles/.

Nombre del archivo

Usa YYYY-MM-DD-titulo-de-entrada.md como nombre de archivo.

Encabezado de la entrada

El encabezado YAML en la parte superior del archivo define la fecha, los autores y los metadatos:

---
contentSchemaVersion: 1
title: "Título de tu Entrada"
description: "Una descripción corta que aparece en la lista del blog."
keywords: [solidiom, web, componente]
locale: es
maturity: draft
date: "2026-08-10"
authors:
  - tu-usuario-github
tags: [solidiom, arquitectura]
---

Contenido de tu artículo aquí...

Nota:Los valores en authors deben coincidir con el id de una entrada en authors.json.

3. Cuerpo del artículo

El formato del artículo es tuyo. Recomendamos añadir una separación de página después del primer párrafo para crear un resumen en la página principal del blog.

Primer párrafo de tu entrada...

<!-- more -->

Resto del contenido del artículo...

4. Campos disponibles

Campo	Tipo	Descripción
`contentSchemaVersion`	`1`	Versión del esquema de contenido.
`title`	`string`	Título del artículo.
`description`	`string`	Descripción corta para la lista del blog.
`keywords`	`string[]`	Términos para búsqueda y SEO.
`locale`	`"en" \| "es"`	Idioma del artículo.
`date`	`Date`	Fecha de publicación en formato ISO.
`authors`	`string[]`	IDs de autores desde authors.json.
`tags`	`string[]`	Etiquetas visibles en la entrada.
`maturity`	`"draft" \| "beta" \| "ga"`	Nivel de madurez del contenido.

5. Previsualiza y envía

Desde la carpeta apps/site/, ejecuta pnpm dev para ver tu entrada enhttp://localhost:4321/es/blog/tu-titulo/.

Una vez satisfecho, abre un Pull Request con tus cambios. El equipo revisará la entrada antes de publicarla.