Remove markup (like images) from page descriptions

[chalin]

For example, page description for the Java landing page contains an image; here's the relevant excerpt from the front matter of https://github.com/open-telemetry/opentelemetry.io/blob/main/content/en/docs/java/_index.md (whose canonical source is https://github.com/open-telemetry/opentelemetry-java/blob/main/website_docs/_index.md):

description: >
  <img width="35" src="https://raw.github.com/open-telemetry/opentelemetry.io/main/iconography/32x32/Java_SDK.svg"></img>
  A language-specific implementation of OpenTelemetry in Java.

While this looks nice in the website page, it causes problems for social media, etc. that expect a plaintext description. This is what the description would look like if you posted to social media:

<img width=&#34;35&#34; src=&#34;https://raw.github.com/open-telemetry/opentelemetry.io/main/iconography/32x32/Java_SDK.svg&#34;></img> A language-specific implementation of OpenTelemetry in Java.

[chalin]

I see that the icons were added via #399 (for example). There are a couple of ways that we can address this so as to preserve the current page display, while fixing social media post descriptions. Let's discuss when you're back @austinlparker, or whoever else would like to share an opinion.

[austinlparker]

What's the best fix here, you think? Editing the template so that we can include the icon as a separate Hugo resource and have it inserted that way?

[chalin]

... template so that we can include the icon as a separate Hugo resource and have it inserted that way

Yes, something like that would do.

[chalin]

I might be able to address this via styling. I'll investigate as soon as I can.

[theletterf]

How can we help here?