docs: adding the icon part to a charm is too hidden away

[sed-i]

Please describe the question or issue you're facing with "Manage icons - Charmcraft dev documentation".

It took me a looong time to discover that this doc has exactly what I needed - a method for including the icon in the charm:

parts:
  icon:
    plugin: dump
    source: .
    stage:
      - icon.svg

This is because:

1. The most important information is hidden (collapsed).

2. The "manage icons" doc, which is what I was following more closely, mentions nothing about it and doesn't link to the icon.svg doc.

---

Reported from: https://documentation.ubuntu.com/charmcraft/4.2/howto/manage-icons/

[tonyandrewmeyer]

@dwilding maybe you're interested here, since you recently updated the how-to? Perhaps the file reference should point to the how-to, or there should be done de-duplication?

[syncronize-issues-to-jira]

Thank you for reporting your feedback to us!

The internal ticket has been created: https://warthogs.atlassian.net/browse/CHARMCRAFT-718.

This message was autogenerated