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

Key principles 101 #10

Open
matuskalas opened this issue Jan 30, 2018 · 10 comments
Open

Key principles 101 #10

matuskalas opened this issue Jan 30, 2018 · 10 comments

Comments

@matuskalas
Copy link
Member

matuskalas commented Jan 30, 2018

Add the key principles of EDAM design that are not obvious, e.g.:

  • What and not How (and even if a bit of how, then only when absolutely necessary). If how is an expected search term, add as either 'Related term' or narrow or related synonym. The primary label should always be more about what (except extreme cases where conceptual distinction is needed, e.g. morphological ops or segmentation techniques)
  • Terms and synonyms cannot be used in multiple concepts. When necessary, add some words|modifiers to the term. Applies to 'Related term'-s, too. (But 'seeAlso' can be the same in multiple concepts)
  • etc.

Add a link to these to https://github.com/edamontology/edam-bioimaging#contributing and the CONTRIBUTE file.

@matuskalas
Copy link
Member Author

matuskalas commented Jan 30, 2018

+ EDITING HINTS

Add to https://github.com/edamontology/edam-bioimaging#editing.

TO N.B.:

  • Ask @matuskalas to get invited to Glip
  • BLOCKER for adding one given subontology at a time; ask @matuskalas to change
  • "Resolved" closes the whole thread! DO NOT use if not the whole thread solved
  • Vice versa, open a NEW THREAD when appropriate

WONDERING: Any way to copy comment threads between concepts in WebProtégé? Would help us unbelievably!!!! And if even between ontologies, woudl be absolutely marvellous!

@joakimlindblad
Copy link
Collaborator

Consider a note on English spelling, with 2-3 examples.

@matuskalas
Copy link
Member Author

I want write something in the sense of "as an effort to help preserving this disappearing cultural heritage, we use "strict" BrE spelling, and latin plural endings" :-DD

@matuskalas
Copy link
Member Author

(and "only North American citizens are allowed to use AmE spelling, but not in primary terms" ;P)

@joakimlindblad
Copy link
Collaborator

And to do that they will have to present a passport at least!

@matuskalas
Copy link
Member Author

matuskalas commented Jan 30, 2018

(Luckily we don't have to mention the use of

  • metric units
  • right-side driving
  • integrated water faucets

But the use of GMT yes;P)

@bogovicj
Copy link

What not How

so.. no need to describe what's under the bonnet of a given algorithm?

@martlj
Copy link
Contributor

martlj commented Jan 30, 2018

Or the mathS behind it.

@matuskalas
Copy link
Member Author

matuskalas commented Jan 30, 2018

so.. no need to describe what's under the bonnet of a given algorithm?

Nie, rozhodne nie ;-)

@bogovicj
Copy link

bogovicj commented Feb 5, 2018

Relating to this:

(except extreme cases where conceptual distinction is needed, e.g. morphological ops or segmentation techniques)

It would be helpful to have some guidance on when/under what conditions distinctions are needed vs when topics should be grouped by being (narrow/related) synonyms of some parent.

E.g., Wavelet Transform and FFT are now "Related Synonyms" to Frequency Analysis, but there are seven children of Morphological operation. What should go into deciding "how deep to go" ?

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

4 participants