boostbook documentation is at serious risk of becoming impossible to use
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 20/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Ferma
- Stack tecnologico
- java
- Ambito
- build-system, documentation
Direzione di ricerca
Inizia esaminando gli script di configurazione di BoostBook duplicati nell'ambiente Docker Ubuntu Bionic e le dipendenze elencate docbook-xsl, docbook-xml e FOP. Determina se versioni supportate possono sostituirli o se è necessario un altro sistema di documentazione; il lavoro è terminato quando la build della documentazione non dipende più dagli strumenti obsoleti identificati.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
I would have opened an "issue" on the boostorg/boostbook project, however, that is not enabled.
I have been duplicating the boostbook setup scripts into the docker setup environment for Ubuntu Bionic and I have found that all of the packages that boostbook depends on are ancient.
| Package | Version | Last Modified | Host |
|---|---|---|---|
| docbook-xsl | 1.75.2 | 2009 | SourceForge |
| docbook-xml | 4.2 | 2002 | oasis-open.org |
| fop | 0.94 | 2007 | Apache |
These tools are quite old and it is only a matter of time before the older versions could be removed. These external sites are under no particular requirement to keep these older versions of software available. At some point some of these tools may no longer work with current operating system tools, for example fop says that it is for "JDK 1.4".
Each of these tools has a newer version. A project should be initiated to modernize the documentation build to use the latest versions of these tools, or switch to another documentation system perhaps (I saw a discussion on the mailing list).
- Lingua principale
- Nessun dato sulla lingua
- Stelle
- 4
- Fork
- 6
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Guida per i contributori
Nessuna guida per i contributori indicizzata per questo repository
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di boostorg/admin
-
Regression test runs, but results don't show in the table. (Is there a log file I could view?) Aperta
Difficoltà 4/5 3-5 giorni Idoneità per principianti 20/100
Tutte le issue di boostorg/admin
Issue simili
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
-
CS0162 "Unreachable code detected" warning from a MSBuildTemp .tmp file in every game project Apertabug
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
-
area:engineering priority:p2 type:bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
jejjohnson/pyrox#234 ·
-
good first issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
-
good first issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
ros2/ros2_tracing#266 · 1 commento ·