← Back to team overview

kicad-developers team mailing list archive

Re: kicad doc build process

 

tir. 12. jun. 2018 09.28 skrev Marco Ciampa <ciampix@xxxxxxxxxx>:

> 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@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~kicad-developers
> More help   : https://help.launchpad.net/ListHelp
>

Follow ups

References