some layers you can just alternate between DownloadAGOL and uploadAgol
DownloadAGOL -> {make some edits} -> Make-PublishingFile -> uploadAgol
(say a polygon layer that you want to make the record locally but you want someone online to attribute them)

in this case we are getting new source records from a distributed collection
and attribute edits we make in AGOL we want to send back to the source records

DownloadAGOL -> push -> {proccess} -> vector collector -> pull -> Make-PublishingFile -> uploadAgol

this is the workflow, it prioritizes content coming frm AGOL
and PULL in this case skipps the fields that AGOL users can edit

since this layer is passed the source_id and the (source)_record_id
it can do a PUSH back to the original sources


SO IF YOU WANT TO MAKE MASS EDITS TO CLEAN UP THE DATA
do it in this layer after running a DownloadAGOL
(and also maybe lock it online so no body uses it..call it a mataince period)
do your edits and then run a Make-PublishingFile -> uploadAgol
(you can also run the whole workflow above but it gets done on the weekend so dont worry about it)







more geenral material about PUSH / PULL
AS A MEANS OF A EXAMPLE...

properties of public interest
is a PULL as it gets its parcels from many counties

but you could have many projects that have created selections of parcels (consumers)
if you wanted to update all of those that used napa county parcels
then you would do a PUSH from napa to all

or if you just wanted to update one of the selection sets
then do a PULL from it againts all authories (each countie says its an authority on "APN")

if you have many consumers and many authorities then you have a bit of a mess
one way to overcome it is to vector collect the authorities and then you can PULL 
againts that vector colllection

thats whats kinda going on here. the data set in this folder recieves attribute updates from local edits and from agol
and it get geometery updates and new records from the ITRF version of the vector collection by doing a PULL. 
if you want these attributes to go back to the lands folder then you have to do a PUSH.