Docs:/streams: try to explain streams lifecycle

[jbtrystram]

I have been struggling a bit to understand how the content is promoted between the streams, so I tried to improve the documentation a little.

I thought of adding a mermaid chart as well but I am not sure if it's really helpful.

Also, delete bodhi-updates references, see #1734

[jlebon]

There are multiple things here in both the old and new texts that aren't quite right/outdated. Some things in the new text also duplicate other sections. WDYT about instead focusing this PR on scrubbing out bodhi-updates and bodhi-updates-testing for now and I can do a follow-up that updates this doc more generally to reflect reality?

[jbtrystram]

WDYT about instead focusing this PR on scrubbing out bodhi-updates and bodhi-updates-testing for now

You are right let's split that out: #1738

[jbtrystram]

@jlebon BTW, what do you think about merging Design.md and stream-tooling.md as they are redundant in some areas ?

There are multiple things here in both the old and new texts that aren't quite right/outdated. Some things in the new > text also duplicate other sections. ... I can do a follow-up that updates this doc more generally to reflect reality?

If you don't mind I'd like to do the follow-up on the doc update. I know it's going to be a slower process, but IMHO the process of figuring this out is valuable :)

[jlebon]

@jlebon BTW, what do you think about merging Design.md and stream-tooling.md as they are redundant in some areas ?

The difference is that the text in Design.md is more about the high-level design, while stream-tooling.md is more about implementation details of how to achieve it. It seems like a useful distinction to maintain for people who want to get acquainted with the model without caring about implementation?

I do think though that stream-tooling.md should probably link to that section of Design.md as a "required reading".

If you don't mind I'd like to do the follow-up on the doc update. I know it's going to be a slower process, but IMHO the process of figuring this out is valuable :)

Works for me!

[travier]

Mostly LGTM. Some nits

[travier]

Ah, looks like Jonathan founds things I missed: #1736 (comment)

[c4rt0]

Closing on behalf of: #1912