kicad-developers team mailing list archive

[jp charras <jp.charras@xxxxxxxxxx>]

Le 25/02/2017 à 18:04, Chris Pavlina a écrit :
> 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.
> 

Thanks, Chris.

Attached the file format docs


-- 
Jean-Pierre CHARRAS

Attachment: board_file_format_EN.odt
Description: application/vnd.oasis.opendocument.text

Attachment: library_file_format_EN.odt
Description: application/vnd.oasis.opendocument.text

Attachment: page_layout_file_format.odt
Description: application/vnd.oasis.opendocument.text

Attachment: schematic_file_format_EN.odt
Description: application/vnd.oasis.opendocument.text

Attachment: s-expr_pcbnew_file_format.odt
Description: application/vnd.oasis.opendocument.text