Abrir un artículo público de Docs
Abre un enlace público directo de Docs, deja que la pantalla de Docs de la landing resuelva el artículo a través del índice público y lee la guía renderizada sin iniciar sesión ni cambiar datos de Grupo Marea Demo o Marea Gran Via.
En este artículo
Usa esta guía cuando un operador, un compañero de soporte o un revisor de documentación necesite confirmar que un artículo público de Docs se abre desde una URL directa de ES en español.
Leer el artículo público es independiente de la acción operativa que describe. Permisos como `users:manage` pertenecen a crear un usuario interno, no a ver esta página de ayuda.
Antes de empezar
- Usa `/docs/accesos/es-access-users-create-location-internal?lang=es-ES`.
- El sitio público de la landing y la API pública de Docs son alcanzables desde el navegador.
- El artículo en español existe en el contenido empaquetado de Docs; `lang=es-ES` se normaliza al locale de Docs `es`.
- La media publicada es opcional para este artículo. La media planificada sin fuente resuelta aparece como marcador.
Instrucciones
- 1.
Abre el enlace público del artículo
Abre `/docs/accesos/es-access-users-create-location-internal?lang=es-ES`. La pantalla de artículo de Docs de la landing debe abrirse directamente sin inicio de sesión, selección de organización ni comprobación de pertenencia a Marea Gran Via.
- 2.
Confirma el artículo resuelto
Cuando cargue el índice público, confirma que el artículo seleccionado está en la sección Accesos y se titula `Crear un usuario interno de ubicación`. La página empareja la ruta por el slug de sección `accesos` y el slug de artículo `es-access-users-create-location-internal`.
- 3.
Lee la guía renderizada
Usa la cabecera del artículo, el resumen, la introducción, los prerrequisitos, los pasos ordenados, las validaciones, el resultado esperado, las guías relacionadas de la misma sección y los anclajes del lado derecho. Trata cualquier permiso de producto mencionado en el artículo como requisito de la acción documentada, no de la lectura de la página pública.
- 4.
Cambia la vista de dispositivo cuando haga falta
Usa el selector de dispositivo de Docs solo cuando necesites contenido o media planificados para otro dispositivo. Cambiar el selector recarga el índice público y el artículo seleccionado con la nueva plataforma.
- 5.
Gestiona los problemas de carga
Si el área del artículo muestra un error, comprueba el origen de la API pública y el slug exacto de sección y artículo. No uses `HEAD /api/public/docs/{path}` para demostrar que existe un artículo concreto, porque el handler puede devolver OK antes de buscar el artículo.
Validaciones y límites
- La página pública resuelve `lang=es-ES` al locale de Docs `es`.
- La petición de índice es `GET /api/public/docs?locale=es&platform={platform}&theme={theme}`.
- La petición de detalle es `GET /api/public/docs/accesos/es-access-users-create-location-internal?locale=es&platform={platform}&theme={theme}` y no envía el texto de búsqueda de la barra lateral como `q`.
- No se requiere usuario autenticado, pertenencia a organización, pertenencia a ubicación ni permiso operativo para leer el artículo público.
- El frontend envía solo `mobile`, `tablet` o `web`; el backend normaliza los valores soportados de plataforma y tema.
- Si no hay coincidencia directa del artículo, la interfaz omite la petición de detalle; un GET directo al backend para un artículo desconocido devuelve `404`.
- La media planificada sin `src` resuelto no bloquea el renderizado del artículo; aparece como marcador de media pendiente.
Resultado esperado
El artículo público de Docs se puede leer desde la ruta de ES y verificar contra el contrato JSON público de detalle sin crear usuarios, asignar roles, abrir solicitudes de soporte ni mutar datos de producto.