-
Notifications
You must be signed in to change notification settings - Fork 0
Description
Apologies for this becoming such a long issue :-)
Throughout the texts, there are (naturally) mentions of Seedcase. However, as a reader, it can be quite confusing to understand what is meant when there's referred to different parts of "Seedcase" .
I think that being more precise with what we call the different parts of Seedcase (the entire project), this might really help clarify what is meant throughout almost the entire documentation :-)
It seems that there are (at least) three parts of Seedcase that are described in various way across the documentations:
- Seedcase Project (the entire thing - including software and documentation of software, culture, collaboration, "how's" and "why's")
- Seedcase Product (the software product)
- Seedcase Data Resource (a specific instance created with the software?)
For me, it gets particularly confusing, with mentions of "Seedcase" or "the Seedcase", because it seems which parts that is differs across the texts. For example:
-
Community/index: "Seedcase" referring to the Seedcase Software (I think?)
-
Design/index: Many mentions of "Seedcase" - but I think it refers to the "Seedcase Software"?
- https://github.com/seedcase-project/seedcase-project/blob/56e3536e6b1bb543e82beea91d95f43fd53433ea/design/index.md?plain=1#L30-L34
- https://github.com/seedcase-project/seedcase-project/blob/56e3536e6b1bb543e82beea91d95f43fd53433ea/design/index.md?plain=1#L37-L39
- https://github.com/seedcase-project/seedcase-project/blob/56e3536e6b1bb543e82beea91d95f43fd53433ea/design/index.md?plain=1#L42-L47
-
Design/software-architecture/Building block view: "the seedcase" referring to (what I believe to be) a "seedcase data resource instance"?
-
Design/software-architecture/introduction:
On top of this, I'm a bit confused about the "data components" vs "software" of seedcase mentioned in design/software-architecture/introduction:
https://github.com/seedcase-project/seedcase-project/blob/d6086fe2ca077597dc7cf00db9d863055f04139e/design/software-architecture/introduction.qmd#L64-L65
as well as the "framework": Is that the entire "Seedcase Project"?
- https://github.com/seedcase-project/seedcase-project/blob/d6086fe2ca077597dc7cf00db9d863055f04139e/design/software-architecture/introduction.qmd#L12-L15
https://github.com/seedcase-project/seedcase-project/blob/d6086fe2ca077597dc7cf00db9d863055f04139e/design/software-architecture/introduction.qmd#L19-L25
Idea: We could implement when users hover their mouse over the different parts, their definitions would come up?
In the following, I have found some specific examples of different words used for the same thing:
The "Seedcase Software Product":
-
Community/blocks: "Seedcase software "Product" itself" vs. "Seedcase the software" vs. "Seedcase Product" vs. "The Product"
-
Design/software-architecture/introduction: First mentions it as "Seedcase software", then defines it as "Seedcase Product", and afterwards refer to it as the "Seedcase software" again
"Seedcase Data Resource":
- design/software-architecture/context (figure): "Seedcase System for Data Resource"
- design/software-architecture/introduction: "One Seedcase "instance" per Data Resource"
- design/software-architecture/runtime-view: "Seedcase-managed Data Resources"
Metadata
Metadata
Assignees
Labels
Type
Projects
Status