Re: KDE Developer Documentation

2019-12-28 Thread Juan Carlos Torres
Hi Valorie! On Sat, Dec 28, 2019 at 1:36 PM Valorie Zimmerman < valorie.zimmer...@gmail.com> wrote: > By the way, the Frameworks Cookbook was written and is still available: > https://community.kde.org/Books for more information. And we did do it in > git! > Thanks! This and the much older devel

Re: KDE Developer Documentation

2019-12-27 Thread Juan Carlos Torres
On Sat, Dec 28, 2019, 08:39 Olivier Churlaud wrote: > Hi, > > At CERN we didn't speak about this, except with the Plasma team who spoke > about having a cookbook based on git containing all the code and > explanations. > > Sebastian Klüger was the one who raised the idea. I have no idea if > some

Re: KDE Developer Documentation

2019-12-27 Thread Olivier Churlaud
Hi, At CERN we didn't speak about this, except with the Plasma team who spoke about having a cookbook based on git containing all the code and explanations. Sebastian Klüger was the one who raised the idea. I have no idea if something came out of this. For frameworks we wanted to break the ide

Re: KDE Developer Documentation

2019-12-27 Thread Juan Carlos Torres
On Fri, Dec 27, 2019 at 10:39 PM Carl Schwan wrote: > It shouldn't be very difficult to create a MediaWiki plugins that embed a > specific file from git in a MediaWiki page. We already have an extension > for Bugzilla integration, so it is possible. But before trying to solve the > technical deta

Re: KDE Developer Documentation

2019-12-27 Thread Carl Schwan
Hi Jucato, Le vendredi, décembre 27, 2019 1:22 PM, Juan Carlos Torres a écrit : > Hi Olivier, > > Thank you for the compliments and the pointers! Having the example code in > the git repo is definitely a great idea to make sure they will always > compile. In line with that, we also need to

Re: KDE Developer Documentation

2019-12-27 Thread Juan Carlos Torres
Hi Carl, Thank you for the response! On Wed, Dec 25, 2019 at 5:59 AM Carl Schwan wrote: > Hi, > thanks for the report. An issue I see currently is that we have three > entries for our KDE frameworks and developer utilities: > > 1. https://kde.org/develop > 2. https://kde.org/products/frameworks

Re: KDE Developer Documentation

2019-12-27 Thread Juan Carlos Torres
Hi Olivier, Thank you for the compliments and the pointers! Having the example code in the git repo is definitely a great idea to make sure they will always compile. In line with that, we also need to make sure that each framework has such an example program that serves as an introduction to that

Re: KDE Developer Documentation

2019-12-24 Thread Carl Schwan
Salut Olivier, Having the tutorial next to the code and that they break the compilation if they are out of date is an excellent idea. There is already something similar in Rust[1] were the example in the api documentation are compiled and executed as test. This make it quite easy to write examp

Re: KDE Developer Documentation

2019-12-24 Thread Carl Schwan
Hi, thanks for the report. An issue I see currently is that we have three entries for our KDE frameworks and developer utilities: 1. https://kde.org/develop 2. https://kde.org/products/frameworks/ 3. https://techbase.kde.org/Welcome_to_KDE_TechBase Maybe we could merge some of them. Could it he

Re: KDE Developer Documentation

2019-12-24 Thread Olivier Churlaud
Hi all (and especially Juan Carlos), I just read your report and it's very interesting. I agree with most of what you wrote. I have some minor precisions to give about Techbase: The goal was to remove (or only archive) the tutorials on techbase and replace them by examples within the framewo

Re: KDE Developer Documentation Support update

2019-03-28 Thread Juan Carlos Torres
On Fri, Mar 29, 2019 at 3:11 AM Olivier Churlaud wrote: > I started porting some tutorials to the repos where they belongs as > examples (for instance KWallet (https://phabricator.kde.org/D14955) and > KMessageBox (https://phabricator.kde.org/D14957). That's awesome! Thanks for getting this st

Re: KDE Developer Documentation Support update

2019-03-28 Thread Olivier Churlaud
Hi Juan Carlos, Le mercredi 27 mars 2019, 14:03:54 CET Juan Carlos Torres a écrit : > Greetings KDE Community! > > I'm Juan Carlos Torres (Jucato on IRC) and I've recently been hired as a > contractor to get the ball rolling on updating our developer documentation. > Over the years, our community