Retain or delete Google Earth Engine tutorial?

[sarah-hlsn]

As part of the larger revamp of the documentation I am currently reviewing the Google Earth Engine tutorial.

However, I am wondering how much value the tutorial and the functions it showcases are adding in general. The functionalities are available in GEE itself, and any CLIMADA user who wants to use these climada.util functions would have to install the GEE API in their CLIMADA environment. There also isn't any function that converts data from GEE to CLIMADA objects, so the overall utility of having this in the core is unclear to me. One could just use GEE for the functionalities shown in the tutorial and then read the resulting rasters as CLIMADA objects (which is a step one would have to do now anyways).

My suggestion short: The functions don't add any interoperability between GEE and CLIMADA in my view, why not make climada.util leaner by removing them? If we want to retain the information in the tutorial for future GEE users in the group, the WCR wiki would be a better home for this. For everyone else, the GEE documentation itself should suffice.

How do others see this? Should we make the effort to maintain this further or not?

[sarah-hlsn]

@chahank @spjuhel @peanutfun Would love your input on this!

[peanutfun]

@sarah-hlsn Indeed, I thought the "Add File" button was for that, but it just opens another text input field 🤦

[peanutfun]

@spjuhel Then people would probably expect that these notebooks will be kept up-to-date with CLIMADA (something we do not want to support for "Snippets") 🤔

[spjuhel]

Yes...
We could put a disclaimer or 'last runned with climada x.x.x'

[sarah-hlsn]

For this specific instance I would argue it is sufficient to retain that information somewhere where group members can access it. Like I said, there is no specific connection to Climada and information on how to do these things is already available to the broad public in the GEE documentation. So in this case, I would suggest putting the notebook on the group server and maybe link to it on the wiki.

[peanutfun]

Then people would probably expect that these notebooks will be kept up-to-date with CLIMADA (something we do not want to support for "Snippets") 🤔

Maybe this is not such a big issue after all. We could use the repo README to make clear that the notebooks are not necessarily maintained