search

redhat-documentation / asciidoc-markup-conventions

How to use AsciiDoc mark-up to properly style elements in Red Hat documentation
https://access.redhat.com/documentation/
17 stars 16 forks source link

GitHub-29: Providing a better emphasis example. #39

Closed bergerhoffer closed 2 years ago

bergerhoffer commented 3 years ago

Fixes #29

bergerhoffer commented 3 years ago

@rkratky or any other @redhat-documentation/adoc-styling-mark-up-conventions members still watching this project, can you take a look through the PRs that I've opened?

samccann commented 3 years ago

I would love to but I've been working on non-asciidoc files for the past 3 years. I've lost track on whether CCS actually supports this approach anymore. I'm not sure whom to ask that question. Maybe start with FCC/mod docs folks?

I think it's a great resource and sad to see it die.

samccann commented 3 years ago

@ncbaratta - do you know if we ever got the tools to work with things like [command]`oc get etc?

ncbaratta commented 3 years ago

@samccann I'm actually not sure what you're asking about.

bergerhoffer commented 3 years ago

@ncbaratta I think that @samccann is talking about the macros that are used in some of the examples, like [command] here:

Use the [command]`oc get` command to get a list of services.

You need to set the :experimental: attribute to be able to use them. I've never worked on a project that has used these, but I think (@rkratky can confirm) that the portal has supported their use since this guide was published, a few years ago.

pmkovar commented 2 years ago

I think this can be safely merged, thanks.