i just realized there was a funny desk drawer image in the repo readme a long time ago.

https://github.com/Esri/developer-support/blob/e33e94c62785877e85514e99e5ae3f5bcb615774/README.md

i think we should bring it back!

https://github.com/Esri/developer-support/tree/master/web-js/4.x/extrude

there should be only one

on 8/17/2016, GitHub started supporting static website hosting directly from the master branch.
https://github.com/blog/2228-simpler-github-pages-publishing

it would probably be a good idea to take advantage of the new setting and make sure master is once again the default branch for the repo.

^{there's a sneaking other part of me that considers the way we have things set up now as a fail-safe (because its harder to accidently push directly to upstream gh-pages following Stack Overflow samples blindly), but i think the cons outweigh the pros.}

disclaimer: i just finished cleaning up another merge conflict to get master and gh-pages and sync.

my original plan was to follow up and write documentation to explain to people some do's and donts for managing multiple branches and keeping them synchronized, but i think it'd be ~3x easier to just get rid of the master branch entirely and make gh-pages our default branch.

what is gh-pages anyway?

naming a branch gh-pages is just a handy shortcut provided by github to let them know that we'd like them to be start serving the content in the branch as a static webpage.

documentation: What is Github pages?

source code:
https://github.com/Esri/developer-support/blob/gh-pages/web-leaflet/browserify/index.html
live website:
http://esri.github.io/developer-support/web-leaflet/browserify/index.html

if a file is not present in the gh-pages branch, it is not possible to run it as a live sample. the fact that we encourage folks to include a Live Sample link in their README is another handy shortcut, but it doesn't provide any magic.

but what about samples that have nothing to do with the web?

the good news is, they are perfectly happy to live in a branch named gh-pages too!

what will we have to do differently?

basically, we'll keep doing our own work in unique feature branches (named: patch or my-cool-new-sample) and start creating pull requests to compare them with gh-pages whether they are a website, an ArcObjects code snippet or a Python script.

thats it.

why were we ever maintaining two different branches if they are supposed to be identical?

i have no idea.

i've created an 'issue' for this because i am looking for feedback from anyone and everyone here. my personal opinion is that we are doing more harm than good by asking folks to try and keep two different authoritative branches in sync, but i am not the boss.

we have quite a few stale branches in this repository that can/should be deleted.

https://github.com/Esri/developer-support/branches

most have already been merged. the only one ahead of master is 'Nick's-Branch', but i've confirmed with @nhaney90 that the commits made their way into master so it can be deleted as well.

i suggest we enforce a fork and pull model for this repository (or at a bare minimum require submitting Pull Requests to merge into master from dedicated feature branches) and explicitly prohibit that contributors push directly to the master branch.

https://help.github.com/articles/using-pull-requests/

this will be beneficial for several reasons

1. a second set of eyes helps spot errors and gives an opportunity to improve both code and documentation quality.
2. it helps avoid merge conflicts
3. its good practice for contributing to strangers projects and working on a codebase which requires more extensive collaboration.

its also important that we document guidelines that explain what is required in order to get contributions merged. particularly the inclusion of enough contextual information in a readme specific to an individual sample to explain to anyone perusing the repository what it should be able to help them accomplish.

can someone take a stab at writing up documentation (similar to this) which outlines the general steps for submitting a pull request?

• fork the repository
• clone a copy of the repository locally
• make sure local master is up to date with the commits upstream
• create a new feature branch
• add a new code sample, and once youre satisfied with the addition, commit the change
• push the change to your fork
• use Github to create your Pull Request
• participate in the discussion with an open mind during code review, utilizing additional commits to make additional alterations
• (optional) squash unique commits down into one when everyone is happy with the PR

and update all relevant links.

I publish a repo a few months ago with a list of custom widgets:
http://esri-es.github.io/Web-AppBuilder-Custom-Widgets/

Do you think that this could be something interesting to add here? I'm not sure because the source code is not hosted directly on that repo, instead it is linked to the owners original source.

Cheers,
Raul

Hi there,

Recently I was testing the 3D Maps and the Cedar Graphics and I have developed two little examples showing how Cedar works and how to make that the Cedar graphics interacts with the map. Those two examples are very similar:

• First example using pie graphics
• Second example using horizontal bars graphics

I will be pleased to create a README.md explaining how it works and send a pull request to ./web-js folder if you want. =)

looks like the sample here: http://esri.github.io/developer-support/web-leaflet/multiple-maps-connected-extent/index.html

has some missing tiles in the first map (e.g. https://b.tiles.mapbox.com/v3/examples.map-i875mjb7/8/68/95.png)

in addition to providing information geared toward internal contributors, contextual information needs to be added for the public (ie: info for consumers in addition to contributors).

1. we need to explain that this is a random collection of samples that have proven useful in individual situations, but that we make no claims as to their fitness otherwise (ie: can people call into support if they don't work?)
2. we should point people to other community resources for training and assistance (even if we're comfortable with the public logging an issue when a sample doesn't work for them). I'm thinking specifically of GeoNet and GIS.stackexchange.com but there may be others.
3. we need to explain the general steps to work with the content (pretty much just download the zip and start digging)

to put it succinctly, the first thing people see needs to appeal to the lowest common denominator.

can we make this public? it is very useful.

I keep getting this error and all I've done is replace the username and password variables.

Traceback (most recent call last):
File "C:\Users\[email protected]\Desktop\Kingery\Python\itemSizeCSV\itemSizeCSV.py", line 34, in
t= ItemCounterHelper.agolAdmin(user,pw)
File "C:\Users\[email protected]\Desktop\Kingery\Python\itemSizeCSV\ItemCounterHelper.py", line 22, in init
self.__token, self.__ssl= self.__getToken(username, password)
File "C:\Users\[email protected]\Desktop\Kingery\Python\itemSizeCSV\ItemCounterHelper.py", line 75, in __getToken
return jres['token'],jres['ssl']
KeyError: 'token'

Any thoughts?

Since these are two distinct APIs, I think it'd be clearer if we separated the two.

there are still 29 results for /master/ in this repository
https://github.com/Esri/developer-support/search?utf8=%E2%9C%93&q=%2Fmaster%2F

since the branch has been removed, all urls which reference /master/ need to be updated to /gh-pages/. preferably using the nifty find/replace in your text editor of choice.

any volunteers?

Hello,

I'm testing out this script and am getting a value error stemming from this line:

The traceback reads:

Any ideas? I'm using Python 2.7...I might be wrong, but the problematic line looks like 3.X formatting, correct? If so, how could this line be modified for 2.7? Any feedback is greatly appreciated!

Clone a copy of the repository locally by clicking the "Clone in desktop" or "Download ZIP" button

or "Download ZIP" button

when selecting 'Download ZIP' only the current state of the files in the repository are packaged, commit history and information about other branches is stripped out (more info here).

anyone new game for making this small change and submitting a pull request?

everyone knows im all for open source and 'defaulting to open', but i think we went a bit overboard giving the entire Developer Support team push access to this repo and consequently automatically subscribing them to email notifications regarding its activity.

why?

1. i've received a couple emails from users who felt the notifications were spam.
2. i think some folks get more intimidated about contibuting knowing that their comments, etc. will be email blasted to a big group.
3. lets face it. github is cooler when its nitch.

obviously there are pros and cons to both approaches, but my general opinion is:

• make repos public (or at least public to the entire arcgis org)
• only grant push privileges to those that have explicitly declared interest in contributing/maintaining

to do:

• create a new smaller write access team composed of the folks who've already jumped in and helped, or expressed interest
• trim Developer Support team down to folks who have either already contributed or expressed interest.

its not hard for others to fork and pull if they want to particate and add more folks to the team in the future.

i'd like to give this issue a week or so to collect other comments to see if anyone else feels differently.

(this is more or less a duplicate ArcGIS/esri-support-sql-repository/issues/3)

can someone take a stab at writing up documentation (similar to this) which outlines what to check for prior to merging pull requests?

• use something like this handy live markdown editor to copy-edit
• if code is present, run it and confirm it generates the expected outcome
• make sure contribution doesn't contain any unnecessary dependencies or other 'bloat'
• make sure documentation is sufficient, and that both a README and inline code comments are present
• make sure the proposed 'diff' doesn't alter anything else unexpected in the repository

I just submitted pull request #210 containing a JS sample with a sample URL to our gh-pages branch. After the PR was approved I was planning to fast forward or submit another PR between gh-pages and master so my readme sample URL was correct per #61. However it seems that an auto-merge is not possible here #211. Did I do something wrong here or is our master and gh-pages branch out of sync?

a few random issues we discussed last night:

• perhaps the pythonistas want to rearrange the directory structure for desktop python samples, online samples and server admin samples that don't actually import arcpy?
• desktop SDK needs to come up with a convention for what exact code they will include in a sample generally and some generic documentation that explains how to wedge it into a new visual studio project so that they aren't importing entire visual studio solutions for code samples that are typically quite small.
• also, despite the fact that the content is meant to be helpful to developers, there's no reason that the documentation can't have personality too. check out this awesome gist from our brother @ngoldman in PDX for a perfect example of technical doc + 🍰

you can find my slides here

I am attempting to update a list of values inside a coded value domain. Before touching the original JSON, I ran it through JSONLint to ensure that I had no syntax issues or other issues. My JSON was confirmed valid.

I keep getting "Invalid definition for 'LastEditDate'." and "Invalid definition for ESRI.ArcGIS.SDS.Metadata.EditingInfo" errors.

How do I get past this hiccup?

ORIGINAL JSON Pothole Patrol.txt

Upated JSON Pothole Patrol JSON.txt

I am trying to update the sync-gdb-in-background android demo, beyond adding the gradle wrapper and updating the ignore list there are references to resources but the res directory is missing. I can try to piece together a res file based on what the project needs, but best if we can introduce a proper res folder.

Is there a reason that we have a LICENSE and a license.txt file in the root of this project?

I might just be confused on the licensing...

i just found this great site which breaks out a variety of essential github/git topics into bite sized articles and videos. its a great resource so i think it'd be a good idea to include links from our own help.

anyone up for tackling this 'enhancement'?

https://github.com/Esri/developer-support/tree/master/web-js/wgs-to-webmercator

It would be helpful if we published the basic format that was expect for the samples that people want to contribute. Or better yet, even a template.

e.g.

TechnologyCategory/Folder/xxx
TechnologyCategory/Folder/README.md

README.md could contain things like...

• How to get it working
• Requirements
• See it live here...

Few other ideas: A high-level README.md in each TechnologyCategory folder would be helpful to see a list of what's there.

Thanks,
AL

Whoopsies @goldenlimit , it looks like this app doesn't have a valid live sample.

In extract-json-from-arcmap-layer, the mxd to msd link is broken.

http://ess.maps.arcgis.com/home/item.html?id=2467871513044597a6a64c9d9d025627

The item you requested cannot be found. 
The item may have been deleted or you may have entered an incorrect URL.

we should mention explicity in the readme that pushing your own commits directly to master is strongly discouraged and that force pushing is strictly prohibited, ideally going as far as mimicing the exact rules Level lists for their OPEN open source projects.

i'd even recommend we go a step further

Hi everyone,

I would like to start adding some node-arcgis code sample, would that be ok?

Cheers!

Developer Support Repository

Welcome to the Developer Support Respository (Re_s_pository???)

all github projects are repositories 😄

Going to fix shortly just wanted to add a reminder.

Sample:
web-js/search-widget-with-customized-geocoder-server

Hey guys!

I was just chatting with @esoekianto and @bsnider about possibly creating a folder for appStudio (qml) samples. It just went into beta 3 and started coming in all the support channels so we thought it might be a good idea. Any thoughts? 💭

Hello,

I've been using this script daily for two weeks without problems, but since yesterday I keep getting an empty zip folder as my result. I've tried it with several different services and it's happening regardless. Any ideas? Feedback greatly appreciated!!!

looking over the homepage it strikes me that our doc for contributors is a lot more fleshed out than the 95% of users who just want to download and check out the samples...

a customer at UC just showed me a really cool sample in here where we show how to create a join on the fly and create a new renderer using DynamicLayers here but she was having a hard time understanding what was going on.

in helping her digest the sample, i have the following suggestions for improvements:

• JS and CSS need to be formatted/tabbed consistently
• the hardcoded reference to @AkshayHarshe 's proxy needs to be removed
• the sample needs inline code comments to describe whats going on. particularly that its up to the developer to know a workspaceID because its not something that is exposed by ArcGIS Server

the readme needs:

• formatted (so that the numbered bullets each have their own line)
• links need to be included to the relevant ArcGIS Server documentation for setting up DynamicLayers and workspaces.
• we need to link to the live gh-pages sample from the readme

is anyone up for tackling this? it needn't be the job of the original author.

@bsnider has been tasked with creating AppStudio Samples.

The samples are designed to showcase a particular component (or small number of related components) without the clutter of a full app. Users should be able to copy qml from a sample (preferable taking a whole qml file) and drop it into their own app.

These are the samples he needs:

• Edit points, lines and polygons –Edit existing features and allow the user to delete and move vertices of existing features, and delete whole features.
• Attribute editing – Select an existing feature and edit its attributes.
• Related record editing – (may be a part of the previous sample or separate) Select an existing feature and edit the attributes of related records.
• Capture lines and polygons - Capture a new line or polygon feature with either screen taps or GPS/Location coordinates
• Snapping line features - (may be a part of the previous sample or separate) Capture a new line or polygon feature by tapping on existing feature vertices.

We also need to strive to emphasis offline capabilities, but also want to avoid filling every sample with download geodatabase code. Consider variations amongst the samples listed above, for example in some you may pre-supply a geodatabase, others may download and some can edit online. Perhaps if number 4 in the list is offline, 5 can be online (as it shows similar functionality).

@bsnider and I will be discussing this in our group meetings.

Please mention which one you would like to work on when you begin working on it.

Looking for help from @goldenlimit @marlak @gdhakal @guo7711 @andr7430 @natas333x2

Hi everyone

I would like if it is possible to point WAB to an ArcGIS for Server service.

If yes please could you tell me further steps?

Best regards
Ezequias Rocha

Popup in side panel Time for some Updates 😄

1. use on style events instead of connect.
2. update comments to be more relevant

For example 1:

function initializeSidebar(map) {
                var popup = map.infoWindow;
                //when the selection changes update the side panel to display the popup info for the 
                //currently selected feature. 
                connect.connect(popup, "onSelectionChange", function() {
                    displayPopupContent(popup.getSelectedFeature());
                });
                //when the selection is cleared remove the popup content from the side panel. 
                connect.connect(popup, "onClearFeatures", function() {
                    dom.byId("featureCount").innerHTML = "Click to select feature(s)";
                    registry.byId("leftPane").set("content", "");
                    domUtils.hide(dom.byId("pager"));
                });
                //When features are associated with the  map's info window update the sidebar with the new content. 
                connect.connect(popup, "onSetFeatures", function() {
                    displayPopupContent(popup.getSelectedFeature());
                    dom.byId("featureCount").innerHTML = popup.features.length + " feature(s) selected";
                    //enable navigation if more than one feature is selected 
                    popup.features.length > 1 ? domUtils.show(dom.byId("pager")) : domUtils.hide(dom.byId("pager"));
                });
            }

For example 2:
An ArcGIS Online web map isn't being used in this sample

                //Create a map based on an ArcGIS Online web map id 
                var map = new Map("map", {
                    basemap: "topo",
                    center: [-98.57, 39.82],
                    zoom: 4,
                });

we need to remove the Leaflet.markercluster readme, examples, jake buildfile and other bloat from the multiple maps connected sample. is the plugin available via CDN? if not, whats the minimum required to make our own sample run?

@bsnider, you up for cleaning this one up?

Use the latest version.

I don't think I have access permissions to create a gh-page. It's always nice to view a live demo of a sample instead of reading through lines of code. @phpmaps Do you have access?

https://github.com/Esri/developer-support/tree/master/web-js/cedar-charts-guage

this is why we do code review... assigning to sample author.

there is a point clustering demo, https://developers.arcgis.com/javascript/3/jssamples/layers_point_clustering.html
and need an extra clusterlayer lib, which is loaded by
var dojoConfig = {
paths: {
extras: location.pathname.replace(//[^/]+$/, "") + "/extras"
}
};

but when i need to use it in angular2, how can i import this extra lib?

for example, in 2945f5a we'd be better off linking to the app here than here

my presentation slides can be found here:
http://jgravois.github.io/presentations/git-er-done-2/

So as some of you may be aware there is a new version of ECMAScript out known as ES2015. It introduces new syntax and some different ways of developing with our JS api. I've been working on a few samples. I propose creating a new folder to hold these samples.

Thoughts?

A few months ago I create a class to make easier to generate static images, could I add a code sample using this class?

Cheers,
Raul

The 1.0 public release milestone has been completed. Can we mark it as completed or close it?
Milestone 1