Public bug reported: I was reading this guide: https://developer.ubuntu.com/en/apps/platform/guides/content-hub-guide
while the first part is really well written, the second one is a bit confusing and mess up in examples. I'm referring to the second part as starting from "App registration as source or destination". There we find this snip for the manifest.json: ``` hooks": { "APPONE": { "apparmor": "APPONE.json", "content-hub": "APPONE.json", "desktop": "APPNAME.desktop" } ``` so we assume that a APPONE has: * an apparmor file called APPONE.json * a content-hub file called APPONE.json * a desktop file called APPNAME.desktop so we are saying that apparmor and content-hub files are the same, and APPONE != APPNAME. Is it right? No, I don't thing so... The right snip of code should be something like: ``` hooks": { "APPNAME": { "apparmor": "APPNAME.apparmor", "content-hub": "APPNAME.content.json", "desktop": "APPNAME.desktop" } ``` And the issue propagates below.. in fact at some point we read: ``` Let’s look at one of these, APPONE.json: { "source": [ "pictures" ] } ``` so, that's APPONE.json (not specified if for apparmor or for content- hub, I assume it's the content-hub's one, but it's not specified)... And (again) some some lines after that: ``` Looking at APPONE.json, we may see something like this: { "policy_groups": [ "networking", "content_exchange" ], "policy_version": 1 } ``` Here I assume that the snip refers to the apparmor configuration, but again.. this is not clear!. If a developer reads this guide for the first time (I tried to understand and to study how Content-Hub works) can be confused by those filenames. Please consider a review for the second part as soon as possible. ProblemType: Bug DistroRelease: Ubuntu 15.04 Package: content-hub 0.0+15.04.20150123-0ubuntu1 ProcVersionSignature: Ubuntu 3.18.0-14.15-generic 3.18.7 Uname: Linux 3.18.0-14-generic x86_64 ApportVersion: 2.16.1-0ubuntu2 Architecture: amd64 CurrentDesktop: GNOME Date: Fri Feb 27 19:53:02 2015 InstallationDate: Installed on 2014-09-18 (161 days ago) InstallationMedia: Ubuntu-GNOME 14.10 "Utopic Unicorn" - Alpha amd64 (20140917) SourcePackage: content-hub SystemImageInfo: current build number: 0 device name: channel: daily last update: Unknown UpgradeStatus: Upgraded to vivid on 2015-01-23 (35 days ago) ** Affects: content-hub (Ubuntu) Importance: Undecided Status: New ** Tags: amd64 apport-bug vivid -- You received this bug notification because you are a member of Ubuntu Bugs, which is subscribed to Ubuntu. https://bugs.launchpad.net/bugs/1426535 Title: content-hub guide is confusing in examples To manage notifications about this bug go to: https://bugs.launchpad.net/ubuntu/+source/content-hub/+bug/1426535/+subscriptions -- ubuntu-bugs mailing list ubuntu-bugs@lists.ubuntu.com https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs