Skip to content
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

use a different file naming system #302

Open
marwahaha opened this issue Sep 20, 2019 · 2 comments
Open

use a different file naming system #302

marwahaha opened this issue Sep 20, 2019 · 2 comments

Comments

@marwahaha
Copy link
Contributor

@rbavery and I taught a workshop with this lesson in it this week.

The most frequent learner complaint was about the filenames. I think they found them strange and cryptic (with acronyms like DTM), too similar (DSM vs DTM), but perhaps too long (DTM_hill_HARV_df).

I think we would prefer to see more "human-friendly" names, like surface_HARV and terrain_HARV_df.

What do you all think?

@jsta
Copy link
Member

jsta commented Sep 20, 2019

Makes sense to me but I'm less familiar with conventions for this type of data. Is it useful for people to know the DTM and DSM acronyms?

@dcarver1
Copy link

I think the acronyms (DSM and DTM) would work just fine if you included the top half of the image in lesson 3 within the introduction section. By providing a clear visualization of what these datasets are, individuals who have not worked with them can find meaning to the three letters.

I do think that the filenames/object names could be improved by removing HARV. The site acronym is inherent in the file path, and aside from US boundaries, all the data comes from a single-site location. It just seems a little redundant and leads to quite a bit more characters over the course of the lesson.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants