← Back to team overview

kicad-developers team mailing list archive

Re: [PATCH] V5 upgrade documentation

 

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
> 


Follow ups

References