Plasma QML documentation

[Aaron J. Seigo]

On Thursday, June 16, 2011 13:08:35 Marco Martin wrote:
> Hi all,
> I've started to document the api of the QML Plasma bindings, the pages are:
> a simple getting started tutorial:

wooooOO! :)) this makes me very, very happy to see.

> * binded qgraphicslayouts and old plasma widgets (i really do *not* want to
> publicize that thing...)

this can perhaps be linked to from a "legacy support" section on the page, and 
point to just the widgets page split out from the JS API (see below more more 
on the splitting)

> * qtextracomponents: they depend just from qt, but i would document them
> there (and yes i still am on the position that image providers cannot even
> remotely replace them :p)

where are QtExtraComponents shipped? Qt itself, or?

> * parts in common with the JS api (except services that are briefly talked
> about): they could be copied but would be harder to update since all work
> would have to be done 2 times: is enough to cross link the needed sections?

what we could do is split the JavaScript API page up into several pages. it's 
already way too long anyways :)

then the main JS API page could link to those pages, and the QML pages could 
link to the relevant ones. we'd just need to ensure that the documentation is 
valid and appropriate for both JS and QML. do you have a list of sections on 
the JS API page that would also be relevant to QML? i can easily do the page 
splitting from there...

> if anybody wants to expand the sections of the guide in any way, please do
> so ;)

i cleaned up a couple of minor issues today while reading it over... hopefully 
others will do similarly :)

-- 
Aaron J. Seigo
humru othro a kohnu se
GPG Fingerprint: 8B8B 2209 0C6F 7C47 B1EA  EE75 D6B7 2EB1 A7F1 DB43

KDE core developer sponsored by Qt Development Frameworks
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part.
Url : http://mail.kde.org/pipermail/plasma-devel/attachments/20110622/7ef528dc/attachment.sig