odataorg.github.io icon indicating copy to clipboard operation
odataorg.github.io copied to clipboard

New intro text on OData Why and What?

Open nicenemo opened this issue 6 years ago • 0 comments

Hi,

I was asked to give an introductionary course on OData. I was please to see the new updated OData tutorals, e.g. Odata in 6 steps. Compliments for who wrote those. This explains the how beautiful.

What is still missing on the OData site is a nice introductionary text. I something like that planned already? There are some great bits and peaces that can be googled but that go in to much detail or are outdated.

IMHO it should describe:

  1. The Why
  2. The Where (Name a few open and commercial services that use it).
  3. The What (without going into to much specification details but highlight the good parts: a. 'JDBC for the web; b.being typed via the schema c. CRUD d. navigating down e. SELECT, FILTER f. paging top/skip
  4. Depending on the audience it can refer to LINQ, Java Streams and or the list monad (without flatmap).
  5. Compare to Swagger and Facebook graph

I think the following is to much detail already: 5. Where the EDM comes from and why does the OData type system looks so much like the CLRs.

nicenemo avatar Feb 13 '19 10:02 nicenemo