Enable publication of API dox on api.kde.org
ClosedPublic

Authored by kossebau on Jan 24 2020, 11:36 AM.

Diff Detail

Repository
R129 Window Decoration Library
Branch
addtoapikdeorg
Lint
No Linters Available
Unit
No Unit Test Coverage
Build Status
Buildable 21619
Build 21637: arc lint + arc unit
kossebau created this revision.Jan 24 2020, 11:36 AM
Restricted Application added a project: Plasma. · View Herald TranscriptJan 24 2020, 11:36 AM
Restricted Application added a subscriber: plasma-devel. · View Herald Transcript
kossebau requested review of this revision.Jan 24 2020, 11:36 AM

I stumbled over that metainfo.yaml file and was wondering whether this would not be a lib that wants to be covered an api.kde.org.
So, is kdecoration still a non-deprecated lib? If so, this change should trigger addition of KDecoration on api.kde.org, similar like KAsync is currently at the toplevel.

zzag added a subscriber: zzag.Jan 24 2020, 12:33 PM

+1

So, is kdecoration still a non-deprecated lib?

Yes, KDecoration2 is a non-deprecated lib.

metainfo.yaml
1

I think Martin didn't step down officially.

zzag added inline comments.Jan 24 2020, 12:36 PM
metainfo.yaml
1

"officially"

kossebau updated this revision to Diff 74558.Jan 29 2020, 12:32 PM

keep Martin noted as maintainer, given no official step-down
rebase to latest master

So, with only positive feedback so far I would be going to merge this on 31st Jan. Or earlier, if you tell me :)

zzag accepted this revision.Jan 29 2020, 12:39 PM
This revision is now accepted and ready to land.Jan 29 2020, 12:39 PM
This revision was automatically updated to reflect the committed changes.

Go for it.

If so, this change should trigger addition of KDecoration on api.kde.org, similar like KAsync is currently at the toplevel.

If we could make a plasma subcategory, that would be great. We have some other potential libs to add. There's a lot of QML plugins and scripting hooks that we should be exposing properly.

Go for it.

If so, this change should trigger addition of KDecoration on api.kde.org, similar like KAsync is currently at the toplevel.

If we could make a plasma subcategory, that would be great. We have some other potential libs to add. There's a lot of QML plugins and scripting hooks that we should be exposing properly.

For such a Plasma subcategory, by the current design of kapidox as I know it, this needs to have one KDE repo to have a metainfo.yaml file which describes such a group of projects.
KApidox itself hacks this in for KDE Frameworks by having the group information for that in its own metainfo.yaml, which works as it is official part of Frameworks as well, cmp. https://phabricator.kde.org/source/kapidox/browse/master/metainfo.yaml

No instant proposal where Plasma could define its group, it should be some repo central to plasma.

No time myself to care for this, sorry. But might be an interesting thing to play with for a beginner, things are mostly documented.