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

glossary #34

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

glossary #34

wants to merge 4 commits into from

Conversation

n1ru4l
Copy link
Contributor

@n1ru4l n1ru4l commented Jul 14, 2022

As discussed in the WG this is the glossary around I initially published on https://theguildoss.notion.site/Distributed-GraphQL-Glossary-890a38ac09c149eb84403ecf08c64b9c

Feel free to add suggestions and terminology from other ecosystems, languages, and solutions.

Adding this as an early draft for people to comment on, it definitely needs a few edits from the terminology already defined within the first meeting.

docs/glossary.md Outdated Show resolved Hide resolved
docs/glossary.md Outdated Show resolved Hide resolved
docs/glossary.md Outdated Show resolved Hide resolved
docs/glossary.md Outdated Show resolved Hide resolved
docs/glossary.md Outdated Show resolved Hide resolved
docs/glossary.md Outdated Show resolved Hide resolved
docs/glossary.md Outdated Show resolved Hide resolved
@n1ru4l n1ru4l marked this pull request as ready for review August 4, 2022 07:51
A “dumb” service or database that exposes raw data. Often a data source is
consumed by a service, for reading and/or persisting business logic state.

It is hard to define a border between Data Source and Service. E.g. a PostgreSQL
Copy link

@charlypoly charlypoly Aug 4, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't the difference between Data Source and Service the presence of business logic? (without entering into DDD terminology)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe data source is not the best term here. A data source does not directly refer to the persistence layer of data, so I can source data from a DB via an API/Interface that also include embedded business logic; the data source is the API, not the DB.
Nonetheless, it's also true that a view on a database can include a business logic. A query can include business logic as well, unless it's a select * from .... The example of the trigger is quite correct.

Comment on lines +111 to +113
The [Global Object
Identification][https://graphql.org/learn/global-object-identification/]
[spec][https://relay.dev/graphql/objectidentification.htm] defines a `Node`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Links fixes

Suggested change
The [Global Object
Identification][https://graphql.org/learn/global-object-identification/]
[spec][https://relay.dev/graphql/objectidentification.htm] defines a `Node`
The [Global Object
Identification](https://graphql.org/learn/global-object-identification/)
[spec](https://relay.dev/graphql/objectidentification.htm) defines a `Node`

Alternatively, you can use the [words][link-ref-name] followed by [link-ref-name]: https://... syntax like below 🤷

@joeynenni
Copy link
Contributor

Perhaps we should add the various "Namespacing" terms because we like to use that specific terminology frequently but it doesn't always mean the same thing to everyone.

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

Successfully merging this pull request may close these issues.

5 participants