kicad-developers team mailing list archive

[Nick Østergaard <oe.nick@xxxxxxxxx>]

Hi Seth

Ok, thank you for your investigation. I will update the docker image to
bionic which uses 0.52 of po4a.

Nick

Den tor. 28. jun. 2018 kl. 23.05 skrev Seth Hillbrand <
seth.hillbrand@xxxxxxxxx>:

> ​Bother.  po4a fixed this back in 2016 (
> https://github.com/mquinson/po4a/commit/86f79e5d341ffcb62da9812101304c3dbb420cc6).
> It looks like our doc server is running 0.47 (the fix didn't get released
> until 0.49)
>
> -S
>
>
>
> Am Do., 28. Juni 2018 um 12:39 Uhr schrieb Wayne Stambaugh <
> stambaughw@xxxxxxxxx>:
>
>> Hey Adam,
>>
>> It will eventually be in the Kicad documentation at
>>
>> http://docs.kicad-pcb.org/stable/en/kicad.html
>>
>> There were some github macros that hauptmech added that broke the
>> documentation build.  Apparently asciidoc was choking on them which is
>> unfortunate as they made the github adoc conversion and viewing much
>> nicer than our vanilla adoc files.  The commit to fix this was made
>> 14hrs ago so it should be built soon.  Once the website is updated, you
>> should be able to grab the link.  If you don't see it within 24 hours,
>> please let me know an I will see if I can get it resolved.
>>
>> Cheers,
>>
>> Wayne
>>
>> On 6/28/2018 1:32 PM, Adam Wolf wrote:
>> > Hi Wayne,
>> >
>> > Has it been decided where this documentation will live?  Is it some
>> > place with a URL?
>> >
>> > Thanks!
>> >
>> > Adam
>> > On Sun, Jun 24, 2018 at 11:24 AM Wayne Stambaugh <stambaughw@xxxxxxxxx>
>> wrote:
>> >>
>> >> hauptmech,
>> >>
>> >> I merged your patch and pushed the changes upstream to the kicad doc
>> >> repo.  Thank you for the help with the documentation.
>> >>
>> >> Cheers,
>> >>
>> >> Wayne
>> >>
>> >> On 06/23/2018 08:54 PM, hauptmech wrote:
>> >>>
>> >>> Attached
>> >>>
>> >>> On 24/06/18 02:46, Wayne Stambaugh wrote:
>> >>>> Hey hauptmech
>> >>>>
>> >>>> For the most part I'm fine with these changes.  I think that the
>> first
>> >>>> two paragraphs (sentences) in the "Schematic Symbol Libraries"
>> section
>> >>>> of the version upgrade document could be merged into a single
>> paragraph
>> >>>> since they are related.
>> >>>>
>> >>>> If no one else objects to these changes, please create a merge
>> request
>> >>>> and I'll merge them into my repo and push them upstream today or
>> >>>> tomorrow.
>> >>>>
>> >>>> Thanks for the help.
>> >>>>
>> >>>> Cheers,
>> >>>>
>> >>>> Wayne
>> >>>>
>> >>>> On 06/23/2018 12:15 AM, hauptmech wrote:
>> >>>>> Hi Wayne,
>> >>>>>
>> >>>>> Really awesome that you are creating this documentation!
>> >>>>>
>> >>>>> A couple thoughts:
>> >>>>> * No one reads documentation unless they have to. Usually after
>> stabbing
>> >>>>> in the dark for a while.
>> >>>>> * If one has to read documentation, one wants it short and to the
>> point.
>> >>>>> * Whatever basic knowledge you want the reader to have about how
>> kicad
>> >>>>> works, they won't have it.
>> >>>>>
>> >>>>> With that in mind I did a little example editing with the following
>> >>>>> goals:
>> >>>>>
>> >>>>> * Link to any info that is a requirement for understanding this
>> >>>>> document. If you can't find any existing documentation to link to,
>> >>>>> that's a good clue that we need to fill in more info locally.
>> >>>>> * Leave out as many extra words as possible.
>> >>>>>
>> >>>>>
>> https://github.com/hauptmech/kicad-doc/blob/master/src/kicad/kicad_upgrading_from_v4_to_v5.adoc
>> >>>>>
>> >>>>>
>> >>>>>
>> https://github.com/hauptmech/kicad-doc/blob/master/src/eeschema/eeschema_symbol_library_table.adoc
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>> It's not formatted as a patch because I only edited a few
>> paragraphs,
>> >>>>> and in those I rewrote things completely as an example of the above.
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>>
>> >>>>> On 23/06/18 04:10, Wayne Stambaugh wrote:
>> >>>>>> I pushed the v5 upgrade document to my personal repo[1] on git
>> hub.  I
>> >>>>>> made it part of the KiCad documentation but I don't have a strong
>> >>>>>> opinion about where to add it.  This just seemed like the most
>> logic
>> >>>>>> place.  Please review it when you get a chance.  If you find any
>> issues
>> >>>>>> let me know, send me a patch, or submit a pull request against my
>> doc
>> >>>>>> repo.  Keep in mind that this document is only to detail the
>> changes
>> >>>>>> that will effect project compatibility with older versions of
>> kicad and
>> >>>>>> the perils of symbol remapping.  Thanks in advance for the help.
>> >>>>>>
>> >>>>>> Cheers,
>> >>>>>>
>> >>>>>> Wayne
>> >>>>>>
>> >>>>>> [1]:
>> >>>>>>
>> https://github.com/stambaughw/kicad-doc/blob/master/src/kicad/kicad_upgrading_from_v4_to_v5.adoc
>> >>>>>>
>> >>>>>>
>> >>>>>>
>> >>>>>> _______________________________________________
>> >>>>>> 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
>> >>>>>
>> >>>>>
>> >>>>> _______________________________________________
>> >>>>> 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
>> >>>> _______________________________________________
>> >>>> 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
>> >>>
>> >>>
>> >>>
>> >>>
>> >>> _______________________________________________
>> >>> 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
>> >>>
>> >>
>> >> _______________________________________________
>> >> 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
>>
>> _______________________________________________
>> 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
>>
> _______________________________________________
> 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
>