<div dir="ltr">Hi Jonathan and David!<div><br></div><div>Thanks for the replies and sorry for not getting back to you ASAP.</div><div><br></div><div>It's good there's Workboard for some of those tasks already. Will be</div><div>easier to keep track of them at least and hopefully we can get the ball</div><div>rolling in the next few months. Wish it could be faster but if we had</div><div>enough manpower for docs, we wouldn't be in this state in the first place.</div><div><br></div><div>I thought that the desktop scripting tutorials are going to be moved to</div><div>userbase (the Plasma ones are already there):</div><div><br></div><div><a href="https://userbase.kde.org/KDE_System_Administration/PlasmaDesktopScripting">https://userbase.kde.org/KDE_System_Administration/PlasmaDesktopScripting</a><br></div><div><br></div><div>Regardless, both scripting guides would have to be updated anyway and</div><div>it's quite a lengthy one.</div><div><br></div><div>It does seem we have a bit of a problem with QML support in our apidocs.</div><div>If I'm not mistaken, it's a limitation with Doxygen that KApidox uses. It does</div><div>already use Doxyqml but the output is less than ideal. It's another area</div><div>we'll have to investigate whether it can be approved or, if not, use a different</div><div>system like how ECM and the HIG do it (with Sphinx).</div><div><br></div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Apr 4, 2019 at 9:01 PM David Edmundson <<a href="mailto:david@davidedmundson.co.uk">david@davidedmundson.co.uk</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">> What areas have received the most interest from new developers? What have been their most frequently asked questions?<br>
<br>
Not quite "plasma", but Kirigami and making QtQuick apps which include<br>
targeting plasma mobile is definitely the biggest area<br>
<br>
> - What problems has the team had with the current docs and systems (apidocs, wiki, etc.)<br>
<br>
On apidocs one big technical problem we have is that we have 2 languages.<br>
<br>
There's C++ code which creates QML/JS bindings.<br>
<br>
Writing a plasmoid or kwin script or whatever (in theory) only<br>
requires knowledge of the bindings, not the C++ API.<br>
We've recently got new devs in core plasma that can't code C++,<br>
probably even more likely for people doing 3rd party stuff.<br>
<br>
Kwin has an outdated wiki:<br>
<a href="https://techbase.kde.org/Development/Tutorials/KWin/Scripting/API_4.9" rel="noreferrer" target="_blank">https://techbase.kde.org/Development/Tutorials/KWin/Scripting/API_4.9</a><br>
Which is horrible as it bears no relation to the code behind it and<br>
gets unmaintained<br>
<br>
Plasma used to do this too, but then moved to trying to making doxygen<br>
try and be useful:<br>
<a href="https://api.kde.org/frameworks/plasma-framework/html/classColorScope.html" rel="noreferrer" target="_blank">https://api.kde.org/frameworks/plasma-framework/html/classColorScope.html</a><br>
<a href="https://api.kde.org/frameworks/plasma-framework/html/classorg_1_1kde_1_1plasma_1_1components_1_1TextField.html" rel="noreferrer" target="_blank">https://api.kde.org/frameworks/plasma-framework/html/classorg_1_1kde_1_1plasma_1_1components_1_1TextField.html</a><br>
<br>
Which is equally horrible as it exposes internals someone using QML<br>
doesn't care about, and documents the methods not the properties.<br>
It also requires these static Doxygen pages which list the registered<br>
QML names which people always break.<br>
<br>
Qt's documentation generates two distinct pages and is amazing:<br>
<a href="https://doc.qt.io/qt-5/qquickitem.html" rel="noreferrer" target="_blank">https://doc.qt.io/qt-5/qquickitem.html</a><br>
<a href="https://doc.qt.io/qt-5/qml-qtquick-item.html" rel="noreferrer" target="_blank">https://doc.qt.io/qt-5/qml-qtquick-item.html</a> show the same class but<br>
as you'd see them with the two languages.<br>
<br>
This is a big problem across all frameworks as we move to using QtQuick more.<br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature">Regards,<br><br>Juan Carlos Torres<br>Jucato<br></div>