Hi Hank ,

why do you think we need experimental here?

• I saw a few pages that used UI macro are broken. The attribute 'experimental' is to mark up a button and other UI. Some articles describe key bindings, which are best visualized with embossed markup.

• UI macro is already used in Quick Docs:
  https://pagure.io/fedora-docs/quick-docs/blob/main/f/modules/ROOT/pages/create-gpg-keys.adoc

Macro is a basic feature of AsciiDoc.

• Consistency
  There are various conventions or habit in describing 'actions' in words. 'Click' or bold face..we need consistency in presenting a button, a keyboard, and keyboard bindings.

Thanks. We didn't this include in our Quick Docs guide. And now we have a lot of articles w/o this tag. Wondering what to do about it. We may have to use sed to add it to avery article, of just to those which use it?

Thanks. We didn't this include in our Quick Docs guide. And now we have a lot of articles w/o this tag. Wondering what to do about it. We may have to use sed to add it to avery article, of just to those which use it?

I think UI attribute is only relevant to those which use it, not every article.

• Option 1: We could update 'AsciiDoc for Fedora' page as this attribute can be used for all other docs repos.

https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/asciidoc-reusable-attributes/

• Option 2: No need to update the guide. UI macro is one of many attributes we don't use actively. Curious people can find it in Antora reference link.

@pboy which option do you prefer so the PR can be merged? I could do option 1 as well.

@pboy, you can close this if both options are not satisfactory.

@pboy, PR created https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/merge_requests/101

Updated the AscciDoc markup guide. If you are okay with this, I'll close this PR in Pagure by Dec 31 2023.

Contributor guide approved. I'm closing this PR.