UniStuttgart-VISUS / damast

Code for the DH project "Dhimmis & Muslims – Analysing Multireligious Spaces in the Medieval Muslim World" (VolkswagenFoundation)
MIT License
10 stars 1 forks source link

Terminology: selecting/brushing+linking vs. filtering/setting active #72

Closed tutebatti closed 2 years ago

tutebatti commented 2 years ago

To have a consistent terminology across all info texts, I would distinguish between

Probably one could add more general principles which are the same in all views or can be attributed to the two things listed above.

At any rate, it would be important to explain these two basic principles on the start page (briefly) and in the documentation (in more detail) and use the terminology introduced there consistently throughout the rest of the descriptive texts.

tutebatti commented 2 years ago

I just saw that there is already a section "terminology and principles" in the new (?) documentation. :)

mfranke93 commented 2 years ago

Yes, as I already mentioned here ;)

tutebatti commented 2 years ago

I'm sometimes overwhelmed with the mass of information. (Am I alone with this?) :smile:

Do you think it is better if you start (not now, but principally) writing that section instead of me writing things not correct that have to be reworked a lot?

mfranke93 commented 2 years ago

To have a consistent terminology across all info texts, I would distinguish between

  • "selecting", which is connected with "brushing+linking" - here, only one element can be selected at once
  • filtering, which sets data active or inactive: in All data mode, inactive data is represented by less saturated colors; in Only active mode, only active data is visible

I think/hope that this is already pretty consistent, but better make sure. And yes, that would be the way to distinguish those.

I'm sometimes overwhelmed with the mass of information. (Am I alone with this?) :smile:

Not at all! But that is one thing why I try to keep issues to a smaller granularity and branches short-living. The issue where I mentioned that has been active for very long, and the branch as well. We have also touched on many different topics in that issue, so no wonder ;) we should try to keep that stuff separate in the future if possible.

In retrospect, the reformulation is a larger project. I hadn't thought it would be at the time. We could have created a project or milestone for it and created multiple issues related to that. But I think it is too late now, I guess you are nearly finished with the texts, right?

Do you think it is better if you start (not now, but principally) writing that section instead of me writing things not correct that have to be reworked a lot?

I think that is a good idea, but I don't have much time right now. Since you are reworking all the texts and have a good overview of what terminology needs to be introduced here: Maybe you can collect these as a bullet list already?

tutebatti commented 2 years ago

But I think it is too late now, I guess you are nearly finished with the texts, right?

Nearly, yes. I'm still not happy with consistency regarding different aspects (terminology, formating, structure), but I'm also a perfectionist when it comes to that. I will need to slow down a little on that side.

Maybe you can collect these as a bullet list already?

Will do. In the html?

mfranke93 commented 2 years ago

Nearly, yes. I'm still not happy with consistency regarding different aspects (terminology, formating, structure), but I'm also a perfectionist when it comes to that. I will need to slow down a little on that side.

I just want to repeat that we can also do changes to this stuff after the initial publication ;)

Will do. In the html?

That would be the easiest.

See also here for some terminology discussion related to this issue.

tutebatti commented 2 years ago

I just want to repeat that we can also do changes to this stuff after the initial publication ;)

Yes, we can. But no, we should not (too much). ;)