Scopes documentation and template update
Now that the new scopes API for 14.04 has landed, we need to update the documentation on developer.
- An updated general overview
- An updated architectural overview
- Updated API docs to be imported to d.u.c/api
- Updated scopes template in Qt Creator
Blueprint information
- Status:
- Not started
- Approver:
- Jono Bacon
- Priority:
- Undefined
- Drafter:
- David Planella
- Direction:
- Needs approval
- Assignee:
- David Planella
- Definition:
- New
- Series goal:
- None
- Implementation:
- Unknown
- Milestone target:
- None
- Started by
- Completed by
Whiteboard
Local scopes:
- query local data, but can use remote sources
- Bindings:
- C++: available
- Go, 90% ready, not a target for 14.04, pending conclusion on cross-compilation issues
- JavaScript in experimental status, on target for post-14.04
Remote scopes:
- recommendation is to create REST servers and register them in the Canonical servers
- however, Python scopes submitted to the Canonical servers are also supported
- we won't be including them on the developer site for 14.04
Unity Scope Tool:
- unity-scope-tool package
- http://
Scope template bug tracker:
- https:/
Scopes API docs:
- Staging (latest version): http://
- Production (pending IS to action an RT to deploy latest changes): http://
Work Items
Work items:
[dpm] Update scopes landing page (http://
[dpm] Update scopes architectural overview (http://
[dpm] Update scopes cookbook, covering remote and local scopes (http://
[knitzsche] Update local scope tutorial copy: INPROGRESS
[stolowski] Update local scope tutorial code: DONE
[dpm] Publish a remote scope tutorial: POSTPONED
[facundo] Publish a remote scope tutorial: POSTPONED
[mhall119] Import local scopes API docs into the d.u.c API site: DONE
[mhall119] Work with IS to deploy the latest API site changes to production (RT#68755): DONE
[mhall119] Resolve unity-8 vs ubuntu-14.04 framework versioning for the scopes API URL: INPROGRESS
[dpm] Publish the remote scopes API on d.u.c manually (https:/
[dpm] Write publishing guide for local scopes: BLOCKED
[dpm] Write publishing guide for remote scopes: POSTPONED
[stolowski] Provide an updated list of the new scopes API concepts and descriptions: DONE
[stolowski] Provide a local scopes template: DONE
[bzoltan] Convert the local scopes template into a Qt Creator template: DONE
[bzoltan] Add click packaging support to the local scopes template in Qt Creator: BLOCKED
[bzoltan] Integrate the scopes toolkit into Qt Creator (bug 1297190): TODO
[stolowski] Check if the Unity Scope Tool can also be run from the build directory (i.e. scope installation is not a requirement): DONE
[stolowski] Provide a list of dependencies required for the SDK to run the scopes template: DONE