rework documentation build process - push hosting base path knowledge up front
Los mantenedores suelen responder en 1 día
@heckj ya está trabajando en esto.
Desde el 8/9/2026.
Evaluación
Este issue todavía no se ha evaluado.
Descripción
We're doing a lot of post-processing that's a side effect of the existing docc process-archive command that applies the hosting base path (such as main, 6.4, or latest) after the various archives are merged.
Per @d-ronnqvist in the Forums (https://forums.swift.org/t/future-of-the-transform-for-static-hosting-subcommand/89304/14) - I'm mis-using that command and all of the details for hosting base paths should be known up-front when invoking the initial convert commands, and that DocC does not have a supported path for adjusting it after the fact using it's UI.
The side effect here is that content (HTML, FavIcon, etc) is getting re-rendered from the default, built-in stubs, so it's loosing content such as embedded HTML, custom values, etc - and we're working around that we post processing overrides after DocC has "done it's thing".
This means the standard library build will need to reflect the corrected hosting base path as well, and then we can work from the download and build the remaining docc archives individually with the correct values before the final step - merging them, with no trailing "transform" step.
Some post-processing is still going to be needed, but this part (at least) should get reset.
It may make sense to also have the CI build only produce a relevant collection of symbol graphs and them assemble them after the fact with the DocC converts all happening from here, in order to both simplify the logic and set this up for multi-platform builds with symbols from various platforms: Linux, Windows, macOS, iOS, etc.
- Lenguaje dominante
- Python
- Estrellas
- 29
- Forks
- 6
- Merge medio
- 2 d 2 h
- PR fusionados (30 d)
- 8
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de swiftlang/docs
-
content migration
Dificultad 1/5 Menos de una hora Aptitud para principiantes 75/100
Los mantenedores suelen responder en 1 día
-
Standard Library documentation includes unavailable enumerationsPosiblemente ocupada @heckj la tomó hace 32 días. Abiertocontent error
swiftlang/docs#175 · 12 comentarios · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
favicon not yet included in docs.swift.orgPosiblemente ocupada @heckj la tomó hace 46 días. Abierto
swiftlang/docs#161 · 3 comentarios · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
content error enhancement
Dificultad 3/5 1-2 días Aptitud para principiantes 52/100
swiftlang/docs#154 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
create an explicit (& independent) 6.4 docs buildQuizá libre de nuevo @heckj la tomó hace 60 días y no hay ningún pull request abierto. Abiertotask
swiftlang/docs#153 · 1 comentario · 1 asignado ·
Los mantenedores suelen responder en 1 día
Todos los issues de swiftlang/docs
Issues similares
-
intake mcp-intake needs-ac needs-human-review priority:medium
Dificultad 2/5 1-3 horas Aptitud para principiantes 67/100
Ikalus1988/MisakaNet#3848 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 75/100
521xueweihan/HelloGitHub#4105 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
igormcsouza/bookloud#54 ·
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
aws-samples/sample-per-model-bedrock#526 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
ok-oldking/ok-wuthering-waves#1802 ·
Los mantenedores suelen responder en 2 días