Add docs page on Source details

[damemi]

This adds a new page on some of the under-the-hood details of how sources work and how they are meant to be used

[BenElferink]

I think this page should be part of the "introduction" page.
Intro should explain the "what is this and how to approach it". Right now for Sources, the intro only has supported workloads and the labels .

[damemi]

My thinking was to add this as a deep dive page and keep the other pages like introduction/creating/deleting brief with only the key info. This goes a lot more into details that I think would be unnecessary or overwhelming in the intro. I did link to this page from the introduction though, what do you think?

[BenElferink]

It only seems like a lot because some of the info is duplicated:

For example the "Source Labels" which exist here and in introduction:

odigos/docs/pipeline/sources/introduction.mdx

Line 23 in e263f5c

All Sources will automatically have 3 labels applied by a mutating webhook in the `instrumentor` component:

Or "Using multiple Sources" which exists here and in create:

odigos/docs/pipeline/sources/create.mdx

Line 70 in e263f5c

You can have a namespace Source and a workload Source that both enable instrumentation for a workload. In this case, if one is deleted, the other will persist instrumentation for the workload.

I think if the duplicates are stripped down, or merged into their existing sections, then the rest of this file can be inserted in introduction.

It'll also be harder to maintain the docs in the future if we have multiple pages mentioning the same things.

[damemi]

Thanks @BenElferink, I think you're right. I updated this to put the information in the Sources introduction page, ptal!

[RonFed]

Do you think this will need revisiting once we implement the Source ownership? wonder if should keep this out until we have an implementation

[damemi]

I think we should say exactly what happens right now, and then yes once we change how Sources work for ownership this should be updated