-
Notifications
You must be signed in to change notification settings - Fork 13
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Guide for Discussions #572
Comments
The new Hub.js Discussions Guide will be useful for devs using this subsystem. This issue enumerates some suggested additions to the guide
|
Great start.
Suggest: "Discussions are linked to ArcGIS Online users through Channels --" Under "Creating Posts", I suggest swapping the first and second examples (i.e. first show w/ a known channel id, then explain that if you have permissions, you can create a channel w/ an initial post in a single call). |
Build a Guide page in that provides an intro to the concepts, and shows a few common flows
I think a lot of the intro content can be pulled from the Confluence Page (https://confluencewikidev.esri.com/display/Hub/Discussions+Architecture+Milestone+Review) but since this is an open source project, it would be really good to have this in the doc / repo vs Confluence
It would also be good to either have the Channel Model doc'd on the IChannel page and similar for IPost, and IReaction
Another thing that's currently hard to determine is what are the checks / validations and where are they applied. What's checked at the API vs what should be checked in the UI etc
This should be written so that any developer on our team can understand the conteps, how they map into the AGO entities and security model, and how to get started with the code.
The text was updated successfully, but these errors were encountered: