[Kicad-developers] kicad doc build process
Hi folks, I would like to know better the organization of the build process (Continuous Integration) for the doc files. What I would like to know precisely is: - who is in charge to run the machines that build the docs - what is the frequency of the build process - where I can find the links to these machines (in the site) - how it works (for better undestanding of the whole process) and how to check if, for instance, I did something wrong... - where is (if there is) some docs for this whole process I think that if all this in not documented, why not document it? For my (very little) experience document processes is one of the best way to improve them... TIA Best Regards, -- Marco Ciampa I know a joke about UDP, but you might not get it. GNU/Linux User #78271 FSFE fellow #364 ___ Mailing list: https://launchpad.net/~kicad-developers Post to : kicad-developers@lists.launchpad.net Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp
Re: [Kicad-developers] kicad doc build process
tir. 12. jun. 2018 09.28 skrev Marco Ciampa : > Hi folks, > I would like to know better the organization of the build process > (Continuous Integration) for the doc files. > > What I would like to know precisely is: > > - who is in charge to run the machines that build the docs > Ajo, but I primarely maimtain it. - what is the frequency of the build process > Every commit - where I can find the links to these machines (in the site) > You browse Jenkins at ci.kicad-pcb.org The specific job is at http://ci.kicad-pcb.org/job/any-kicad-doc-head/ It has been failing since https://github.com/KiCad/kicad-doc/commit/f7e9226902156d79459ad63b1a9a39 3a3b5da829 I guess that there are some new dependencies that needs to be installed as of https://github.com/KiCad/kicad-doc/issues/588 - how it works (for better undestanding of the whole process) > and how to check if, for instance, I did something wrong... > Check the build jon on Jenkins. - where is (if there is) some docs for this whole process > > It just does cmke amd make. no magic involved. I think that if all this in not documented, why not document it? > > There is no magic to document as such. For my (very little) experience document processes is one of the best > way to improve them... > I guess the best improvement we could wish for for the docs is faster build times. Historically we talked about comparing the build times and out with asciidoctor vs asciidoc. I don't think we ever managed to get this done. > TIA > > Best Regards, > > -- > > > Marco Ciampa > > I know a joke about UDP, but you might not get it. > > > > GNU/Linux User #78271 > FSFE fellow #364 > > > > > ___ > Mailing list: https://launchpad.net/~kicad-developers > Post to : kicad-developers@lists.launchpad.net > Unsubscribe : https://launchpad.net/~kicad-developers > More help : https://help.launchpad.net/ListHelp > ___ Mailing list: https://launchpad.net/~kicad-developers Post to : kicad-developers@lists.launchpad.net Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp
Re: [Kicad-developers] kicad doc build process
On Tue, Jun 12, 2018 at 10:31:55AM +0200, Nick Østergaard wrote: > tir. 12. jun. 2018 09.28 skrev Marco Ciampa : > > > Hi folks, > > I would like to know better the organization of the build process > > (Continuous Integration) for the doc files. > > > > What I would like to know precisely is: > > > > - who is in charge to run the machines that build the docs > > > > Ajo, but I primarely maintain it. > > - what is the frequency of the build process > > Every commit > > - where I can find the links to these machines (in the site) > > You browse Jenkins at ci.kicad-pcb.org > > The specific job is at http://ci.kicad-pcb.org/job/any-kicad-doc-head/ > > It has been failing since > https://github.com/KiCad/kicad-doc/commit/f7e9226902156d79459ad63b1a9a393a3b5da829 > > I guess that there are some new dependencies that needs to be installed as > of https://github.com/KiCad/kicad-doc/issues/588 Ok will someone please make this working again? Every day it does not work I miss revisions from users... I can help if someone explains me how to or give me access to the system... TIA -- Marco Ciampa I know a joke about UDP, but you might not get it. GNU/Linux User #78271 FSFE fellow #364 ___ Mailing list: https://launchpad.net/~kicad-developers Post to : kicad-developers@lists.launchpad.net Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp
Re: [Kicad-developers] kicad doc build process
Hi, On 12.06.2018 16:54, Marco Ciampa wrote: >> I guess that there are some new dependencies that needs to be installed as >> of https://github.com/KiCad/kicad-doc/issues/588 > Every day it does not work I miss revisions from users... FWIW, I have a working setup at http://darine.hogyros.de:8080/job/any-kicad-doc-head/ This one just installs texlive-full, which is probably overkill but contains everything that is needed to build CJK documents. Copying that config back to the official server should be doable, although I use a chroot to build docs. Simon signature.asc Description: OpenPGP digital signature ___ Mailing list: https://launchpad.net/~kicad-developers Post to : kicad-developers@lists.launchpad.net Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp
Re: [Kicad-developers] kicad doc build process
The normal build job is up again. 2018-06-12 16:54 GMT+02:00 Marco Ciampa : > On Tue, Jun 12, 2018 at 10:31:55AM +0200, Nick Østergaard wrote: > > tir. 12. jun. 2018 09.28 skrev Marco Ciampa : > > > > > Hi folks, > > > I would like to know better the organization of the build process > > > (Continuous Integration) for the doc files. > > > > > > What I would like to know precisely is: > > > > > > - who is in charge to run the machines that build the docs > > > > > > > Ajo, but I primarely maintain it. > > > > - what is the frequency of the build process > > > > Every commit > > > > - where I can find the links to these machines (in the site) > > > > You browse Jenkins at ci.kicad-pcb.org > > > > The specific job is at http://ci.kicad-pcb.org/job/any-kicad-doc-head/ > > > > It has been failing since > > https://github.com/KiCad/kicad-doc/commit/f7e9226902156d79459ad63b1a9a39 > 3a3b5da829 > > > > I guess that there are some new dependencies that needs to be installed > as > > of https://github.com/KiCad/kicad-doc/issues/588 > > Ok will someone please make this working again? > > Every day it does not work I miss revisions from users... > > I can help if someone explains me how to or give me access to the system... > > TIA > > -- > > > Marco Ciampa > > I know a joke about UDP, but you might not get it. > > > > GNU/Linux User #78271 > FSFE fellow #364 > > > > ___ Mailing list: https://launchpad.net/~kicad-developers Post to : kicad-developers@lists.launchpad.net Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp
Re: [Kicad-developers] kicad doc build process
On Thu, Jun 14, 2018 at 08:48:01AM +0200, Nick Østergaard wrote: > The normal build job is up again. > Many, many thanks Nick! -- Marco Ciampa I know a joke about UDP, but you might not get it. GNU/Linux User #78271 FSFE fellow #364 ___ Mailing list: https://launchpad.net/~kicad-developers Post to : kicad-developers@lists.launchpad.net Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp