Refreshing API docs for calligra apps

Jaroslaw Staniek staniek at kde.org
Sun Sep 18 20:34:11 BST 2016


Hi,
tl;dr: Using the kapidox tool is an idea to have slightly better quality of
generated docs and less work mid term.
Are there any folks interested in helping out with adjusting API docs
format of calligra.git to refresh API docs that are currently at
https://api.kde.org/bundled-apps-api/calligra-apidocs/? Note, it does not
include writing docs, it's hopefully a minimal adjustment to make kapidox
work.

I am planning to adjust docs from kexi.git and from repos of "kexi libs".

Background:
(I asked for advice on what can be done to refresh API docs for calligra
apps. I did so on the sysadmin project, the task is
https://phabricator.kde.org/T3755 but because it's not publicly accessible
I have attached the log and moved the discussion to the Calligra list.
Olivier and Ben are in CC here, please keep them added as they were
involved in discussions).

A new proposal from Olivier Churlaud is to move API docs for Calligra apps
(and libs) to a more prominent place at https://api.kde.org, where for
example you can already find Marble and Okular. I see no reason why
Calligra wouldn't go there in the same way. By API docs we mean not app's
documentation of classes, possible design, and such, *not* necessarily
public API of these apps. Such API may not exists, yet the apps qualify for
having the API docs regularly generated and published for convenience of
current and future contributors that look around learn the architecture,
etc. This is how it all worked so far.

-- 
regards, Jaroslaw Staniek

KDE:
: A world-wide network of software engineers, artists, writers, translators
: and facilitators committed to Free Software development - http://kde.org
Calligra Suite:
: A graphic art and office suite - http://calligra.org
Kexi:
: A visual database apps builder - http://calligra.org/kexi
Qt Certified Specialist:
: http://www.linkedin.com/in/jstaniek
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/calligra-devel/attachments/20160918/fbbe32e3/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: T3189.pdf
Type: application/pdf
Size: 83851 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/calligra-devel/attachments/20160918/fbbe32e3/attachment.pdf>


More information about the calligra-devel mailing list