kicad-developers team mailing list archive

[Wayne Stambaugh <stambaughw@xxxxxxxxx>]

On 2/25/2017 12:04 PM, Chris Pavlina wrote:
> On Sat, Feb 25, 2017 at 11:52:28AM -0500, Wayne Stambaugh wrote:
>> On 2/25/2017 11:28 AM, Chris Pavlina wrote:
>>> On Sat, Feb 25, 2017 at 11:04:46AM -0500, Wayne Stambaugh wrote:
>>>> On 2/24/2017 5:22 PM, Kevin Cozens wrote:
>>>>> On 2017-02-23 01:29 AM, Nick Østergaard wrote:
>>>>>> The docs are not quite ready yet,
>>>>>
>>>>> Documentation is (almost) always the last thing to get written or
>>>>> updated. I was making use of the file formats document while working on
>>>>> a project of mine to convert schematics from another program in to one
>>>>> that can be read by Kicad. I found a lot of issues with the docs.
>>>>>
>>>>> I was told Wayne maintains that document. I'll be emailing him to find
>>>>> out what the procedure is for providing information about the changes
>>>>> needed.
>>>>>
>>>>
>>>> I do not maintain nor did I write any of the file format documents.  I
>>>> believe JP wrote them and maintains them.  I will try to do a better job
>>>> when I implement the new schematic and symbol library file formats but I
>>>> cannot promise anything.  I fully intended on writing the new board and
>>>> footprint library file formats but I just couldn't find the time so JP
>>>> graciously stepped up and wrote them for me.  Now that I am project
>>>> leader, I have even less time for such endeavors.
>>>
>>> I still think you should just put them in the repo with the code, and
>>> start requiring people to edit them when they change anything about the
>>> format. Much easier for you than having to maintain them yourself. Just
>>> require proper versioning so that there is a format document version
>>> corresponding to every format version.
>>
>> I'm OK with that as long as we can reformat them to markdown to match
>> our current developer documentation.  This way it gets automatically
>> generated and uploaded to the website.
> 
> I'll happily convert them to Markdown. Send me the most recent versions
> just to make sure I've got the right documents.

I just looked in the doc repo on github and they are no longer there.
There is a copy of the last changes in the legacy repo on launchpad.
Has anyone else made any changes to the file format docs somewhere else
that I don't know about?  If not, then these are the latest.

http://bazaar.launchpad.net/~stambaughw/kicad/doc-read-only/files/head:/doc/help/file_formats/docs_src/

> 
>>
>>>
>>>>
>>>> Cheers,
>>>>
>>>> Wayne
>>>>
>>>> _______________________________________________
>>>> 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
>>