Gentlemen, Once we have the cmake configuration code ready to go and all of the odt file converted to asciidoc (they don't have to be completely cleaned up), I would like to push the repo to https://github.com/KiCad/kicad-docs. Since this is where the libraries and the source mirror currently reside and I have admin privileges on this account, it makes sense to make this the official repo for the kicad documentation. Once documentation is there, I will give access to the necessary developers to begin merging documentation pull requests. If you don't have a github account, please get one so you can contribute to the documentation effort.
Cheers, Wayne On 2/13/2015 5:36 PM, Marco Ciampa wrote: > On Fri, Feb 13, 2015 at 08:52:28PM +0000, Brian Sidebotham wrote: >> Hi Marco, >> >> To bring more people in on the documentation effort, I'd like to >> create a GitHub repo under the KiCad organisation so that people know >> it's the official place to work on the documentation. >> >> Do you think that's a good idea too? > > No problem for me as long as I have direct write access to it for > convenience (=speed) and to continue my port. > >> Do you want me to do recruitment for translation or documentation >> conversion or do you want me to just let you carry on doing the >> conversion and italian translation for a while? > > Well if it will be placed into an "official" place, during the > announcement could be a good idea to stress to the fact that anyone is > willing to help is welcome (but of course this is always true, isn'it? > There is always paucity of hands in the open/free source world... ;-) > >> It's up to you, I don't want to step on your amazing documentation >> effort. > > From the start I said that I will be grateful for every help I receive... > and this is not amazing if you understand my motivation... > > 1) First of all I am lazy > 2) I was willing to start translating in Italian KiCad docs > because > a) I was willing to know more about KiCad and this is a good method > to read all docs throughly, > b) I find that translating into my native language all the KiCad docs, > I understand them better. > 3) updating a translation from ODT is a nightmare and I am not willing to > wasting my time translating something that in a few months could become > obsolete and not easy to update > > so my motivations comes down to spare my time (and yes, hoping at the > same time to do the same for other people too). > >> I'm just going to be adding a CMake build system to it. > > I know, and I thank you since I really do not know anything about CMake > (and my knowledge of make is scarce too anyway...) > >> I'd like the repo to be under the KiCad organisation umbrella though >> so people know it's now official. > > Don't worry I understand and agree. > > I have only one concern: I reckon (but I could be totally wrong) that > converting a makefile into CMake could be difficult for you if you do not > understand completely why it works the way it does. > > My stupid toolchain with just make and a few scripting is working in a > satisfactory way for my goal to have it working on my Ubuntu. > > I really do not know how to convert it into CMake without breaking its > functionality and I am going to miss it if I want to continue updating it > while you are working on it. > > I am afraid that could not be possible to mix and match two build sistems > (make and CMake) without affecting the functionality of one or the other. > > So, maybe its better for you to just try and make a toolchain working for > just a little document, say CvPcb, (that I already have completely > translated into Italian), in the same way as I have done myself from the > start. When it fully works, producing multiple language and multiple > format versions correctly, it will be really easy to add all the other > docs to your CMake toolchain. > > So for now you can start an unofficial dev branch with the CMake > toolchain and CvPcb and its translation(s) with it. When it works I will > add all the other docs that I can continue update in the meantime. We can > test it with all the docs and if it works satisfactorily we can "bless" > it and merge it into the official git doc repo. > > What do you think about it? > > -- > > > Marco Ciampa > > I know a joke about UDP, but you might not get it. > > +------------------------+ > | GNU/Linux User #78271 | > | FSFE fellow #364 | > +------------------------+ > > > _______________________________________________ > Mailing list: https://launchpad.net/~kicad-developers > Post to : [email protected] > Unsubscribe : https://launchpad.net/~kicad-developers > More help : https://help.launchpad.net/ListHelp > _______________________________________________ Mailing list: https://launchpad.net/~kicad-developers Post to : [email protected] Unsubscribe : https://launchpad.net/~kicad-developers More help : https://help.launchpad.net/ListHelp
