intro to briefings guide 3/4 #2442
Conversation
ManushiM
requested review from
achapkowski,
cariashuang0417,
jtroe,
jyaistMap,
kgalliher,
nanaeaubry,
nparavicini7 and
tarunkukreja003
|
Check out this pull request on See visual diffs & provide feedback on Jupyter Notebooks. Powered by ReviewNB |
kgalliher
left a comment
kgalliher
left a comment
There was a problem hiding this comment.
Looks good. A couple of minor grammatical and formatting suggestions. The final cells don't work for me but I'm not sure that's a dealbreaker.
| "source": [ | ||
| "### Concept of slides and blocks\n", | ||
| "\n", | ||
| "Similar to traditional presentations with slides, `Briefing`s come with `BriefingSlide`s to add structured content to your Briefing.\n", |
There was a problem hiding this comment.
Does Briefings need to be code highlighted?
| @@ -0,0 +1,858 @@ | |||
| { | |||
There was a problem hiding this comment.
This is a good way to start. However, as a new user I would not understand where these classes are coming from or where the Image class popped up from and why you are creating it.
I would add the same intro as for the StoryMap content guide where you list all the available content classes for a Briefing. Since there are also Briefing specific classes those should be included and detailed here as well.
Users understand Briefings in a storymap editor context but that understanding needs to be mapped here since this could be the first time they are seeing any of this. (most likely is if they are looking at the intro guide).
Reply via ReviewNB
There was a problem hiding this comment.
I updated this with the same intro as the StoryMap guide, however are any of these content elements not supported for Briefing?
There was a problem hiding this comment.
Yeah you can go into the briefing creator and see what can be added:
| @@ -0,0 +1,858 @@ | |||
| { | |||
There was a problem hiding this comment.
Specify this is a WebMap item we are grabbing from our organization to add as a Map content to the Briefing.
Reply via ReviewNB
nanaeaubry
left a comment
nanaeaubry
left a comment
There was a problem hiding this comment.
Add more info for everything. If markdowns are not present I think comments can be added to the code cells to make it clearer.
Users looking at this guide are more likely than not complete newbies to the module
nanaeaubry
left a comment
nanaeaubry
left a comment
There was a problem hiding this comment.
Thanks for addressing the comments. Looks good from my end 👍🏻
3 participants
Guide 3 of 4, introduction to briefings.
Closes https://github.com/ArcGIS/geosaurus/issues/12370
Checklist
Please go through each entry in the below checklist and mark an 'X' if that condition has been met. Every entry should be marked with an 'X' to be get the Pull Request approved.
imports are in the first cell?arcgisimports? Note that in some cases, for samples, it is a good idea to keep the imports next to where they are used, particularly for uncommonly used features that we want to highlight.GISobject instantiations are one of the following?gis = GIS()gis = GIS('home')orgis = GIS('pro')gis = GIS(profile="your_online_portal")gis = GIS(profile="your_enterprise_portal")./misc/setup.pyand/or./misc/teardown.py?api_data_owneruser?api_data_owneraccount and change the notebook to first download and unpack the files.<img src="base64str_here">instead of<img src="https://some.url">? All map widgets contain a static image preview? (Callmapview_inst.take_screenshot()to do so)os.path.join()? (Instead ofr"\foo\bar",os.path.join(os.path.sep, "foo", "bar"), etc.)Export Training Data Using Deep Learningtool published on geosaurus org (api data owner account) and added in the notebook usinggis.content.getfunction?gis.content.getfunction? Note: This includes providing test raster and trained model.