The C API docs for 14.04 and 14.10 are missing

[Roberto Alsina]

Looks like the API docs for 14.04 and 14.10 were never fully generated. Compare

http://developer.ubuntu.com/api/devel/ubuntu-14.04/c/

with http://developer.ubuntu.com/api/devel/ubuntu-14.10/

and http://developer.ubuntu.com/api/devel/ubuntu-13.10/c/

Reported from: http://developer.ubuntu.com/?page_id=

[Nicholas Skaggs (nskaggs)]

Roberto, thank you for your report. Can you explain what you mean in more detail? The APIs should be fully synced an available on the site. For instance, for qml;

http://developer.ubuntu.com/apps/qml/api/

This has both 14.04 and 14.10 apis.

[Roberto Alsina (ralsina)]

There's a lot of API docs that should be generated automatically from
sources, and they don't seem to be. For example, if someone wants to use
the messaging menu API, on 13.10 he could read
http://developer.ubuntu.com/api/devel/ubuntu-13.10/c/MessagingMenu-1.0.html
but there's no equivalent for 14.10.

Same for some 50 other C APIs that are not (AFAIK) deprecated, and lots
more.

On Tue, Aug 19, 2014 at 1:29 PM, Nicholas Skaggs <
<email address hidden>> wrote:

> Roberto, thank you for your report. Can you explain what you mean in
> more detail? The APIs should be fully synced an available on the site.
> For instance, for qml;
>
> http://developer.ubuntu.com/apps/qml/api/
>
> This has both 14.04 and 14.10 apis.
>
> ** Changed in: ubuntudeveloperportal
> Status: New => Incomplete
>
> --
> You received this bug notification because you are subscribed to the bug
> report.
> https://bugs.launchpad.net/bugs/1334275
>
> Title:
> The C API docs for 14.04 and 14.10 are missing
>
> Status in Ubuntu App Developer site:
> Incomplete
>
> Bug description:
> Looks like the API docs for 14.04 and 14.10 were never fully
> generated. Compare
>
> http://developer.ubuntu.com/api/devel/ubuntu-14.04/c/
>
> with http://developer.ubuntu.com/api/devel/ubuntu-14.10/
>
> and http://developer.ubuntu.com/api/devel/ubuntu-13.10/c/
>
> Reported from: http://developer.ubuntu.com/?page_id=
>
> To manage notifications about this bug go to:
>
> https://bugs.launchpad.net/ubuntudeveloperportal/+bug/1334275/+subscriptions
>

[Launchpad Janitor (janitor)]

[Expired for Ubuntu App Developer site because there has been no activity for 60 days.]

[Roberto Alsina (ralsina)]

So, there's no plan to actually expose these APIs on that site?

[David Planella (dpm)]

There are a couple of bits of context that might be worth adding here:

- Originally, API documentation was generated by a set of scripts. It's now being generated by a full-fledged django app
- Originally, the developer site was desktop-centric. When we announced the phone launch, we made the site phone-centric, removing the links to the desktop documentation, and moving some to unity.ubuntu.com

So to answer the question, there is no plan to bring back the Unity 7 API docs onto developer.ubuntu.com. Until we achieve full convergence (which will effectively mean d.u.c. will cover both desktop and mobile), those docs should be better linked to from unity.ubuntu.com. The challenge here is that there is no clear owner of that site at the moment.

[David Planella (dpm)]

One bit I missed on my last comment:

http://developer.ubuntu.com/api/devel/ubuntu-14.04/c/

The C documentation for the Unity 7 set of APIs is still being generated on a cron job, though, but it's not really being maintained. It's being published by the set of scripts which were the predecessors of the current API website.

[Michael Hall (mhall119)]

Marking this as Won't Fix, but eventually these docs will come back either on developer.u.c once the Unity 8 APIs for them exist, or on unity.u.c if we can get them hosted there.