Better proposed APIs desc

[matzew]

Fixes SRVCOM-2668

Proposed Changes

• offers more meaningful description of our provided APIs

[ReToCode]

I like it 🎉
/cc @rhuss

[Preeticp]

LGTM

[Cali0707]

@matzew feel free to ignore if you disagree, just my 2 cents on the wording of the Kafka bits

[matzew]

I think the text for Serving is a bit long here. I think I tend to have a more crisp description, as smaller text is easier to parse/read... 🤷‍♂️

[matzew]

Latest updates ^

[ReToCode]

LGTM

[pierDipi]

what do you think about this instead?

Suggested change

	- description: Additionl extensions based on Apache Kafka for production-ready Knative Eventing deployments
	- description: Knative Kafka is the Knative Eventing extensions for Apache Kafka. It allows to trigger services based on Apache Kafka topics and create your event-driven applications with a simple HTTP interface with the the underlying reliability and efficiency of Apache Kafka.

[matzew]

that's quite a mouthful. How about:

Knative Kafka is the Knative Eventing extensions for Apache Kafka. Create event-driven applications with a simple HTTP interface while leveraging the underlying reliability and efficiency of Apache Kafka

[matzew]

This is the current ^

[pierDipi]

LGTM

[Cali0707]

LGTM

[Preeticp]

LGTM

[rhuss]

I would shorten the Serving description to:

Knative Serving simplifies application deployment, enables scaling from and to zero replicas, and enables advanced traffic routing use-cases.

• There is no such thing like a "severless container"
• Be explicit what to scale

[rhuss]

Some thoughts on the descriptions to make them more concise and aligned in the format (e.g. the Knative Kafka description is not in the same style as the others:

• Knative Serving: A platform for streamlined app deployment, traffic-based auto-scaling from zero to N, and traffic-split rollouts.
• Knative Eventing: An OpenShift-native EDA runtime platform that leverages Cloud Events with a simple HTTP interface.
• Knative Kafka: An extension to Knative Eventing, merging HTTP accessibility with Apache Kafka's proven efficiency and reliability.

I believe these very condensed and concise descriptions highlight the core features. Is there anything missing?

[matzew]

Latest proposal....

[rhuss]

/lgtm

thanks!

[openshift-ci]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: matzew, rhuss

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [matzew,rhuss]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[nainaz]

Love It!