← Back to team overview

kicad-developers team mailing list archive

Re: Kicad future documentation - first draft


Dear Kerusey,
good morning.
thanks for the feedback. Just few questions so that I can try to make
the doc more likeable to you and possibly others.

# What do you mean with "the new KiCad documentation should  be a
big-bang for the future readers"? is this anyway related to the Geneva
neutrino? (...just kidding)
# What aspect of the KiCad icon don't you like? What icon would you
have in mind? Kicad icon is currently the dominant icon because it is
not the icon of an application per se but the icon of the whole suite,
therefore I though of giving it a general non-application look.  Send
me an .svg of what you might like.
# Are we talking about the KiCad icon or the icon in the manual cover?
# What kind of icon would you like for CvPCB? Please, if you can, send
examples. Lots of improvement can be done with this icon.
# What do you mean by "what the Canonical says"?
# What do you mean by "Your layout is too "polite""? If you have a
look at the style available in this template you can see that there
are styles for all possible element of a manual. This template is the
template of the official libreOffice documentation and It was designed
by several people who I think know stuff. I'm not sure I can do better
than them but If you think you can please send it to me and we can ask
around for opinions.
Have a look here:

cheers mate

On Mon, Sep 26, 2011 at 11:33 PM, Kerusey Karyu <keruseykaryu@xxxxx> wrote:
> Dnia 2011-09-26, pon o godzinie 17:14 +0200, fabrizio pisze:
>> Dear All,
>> I seem to understand that the use of the .odt (and pdf) format and
>> LibreOffice as main editor is the choice preferred by most of the
>> people.
> LibreOffice or OpenOffice. No matter.
>> In attachment you can find the document  kicad_en.pdf modified and
>> updated. The following modifications where made:
>> - front cover was redesigned (any suggestions for improvement?)
> This KiCad main icon is ugly. :( This form is good for documents, but
> not for the whole application. Anyway, compare it yourself with the rest
> of icons of the KiCad Suite members. Clearly does not fit. BTW: Why
> CvPCB icon has a blue base?
> The text is ok, but what the Cannonical says...
>> - A quite cool template (taken from the official open office
>> documentation) was used to restyle the whole doc.
>> - New icons and screenshots (all included as local links)
>> - some minor corrections
> IMHO the new KiCad documentation should be a big-bang for the future
> readers. In general.
> Your layout is too "polite". Especially with these smoothing green
> headers. The Arial font or his equivalent - it already was.
> Lack of emphasis for important key words, no monotype in file paths or
> names - the fundamental elements of IT manuals are missing.
> Sorry. But I do not like it.
> Kerusey Karyu
> _______________________________________________
> 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