DOC-1928: Fix inline code styling inside admonitions

Farzad Hayatbakhsh · Farzad Hayatbakhsh · commit 3ab64be19a47 · 2024-12-23T10:14:58.000+10:00
diff --git a/modules/ROOT/partials/configuration/autocorrect_service_url.adoc b/modules/ROOT/partials/configuration/autocorrect_service_url.adoc
@@ -5,7 +5,10 @@ This option specifies the URL of the server-side `+ephox-spelling+` service.
 
 For instructions on how to set up a Spellchecking server-side component, see: the xref:introduction-to-premium-selfhosted-services.adoc[server-side component installation guide].
 
-NOTE: `autocorrect_service_url` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}].
+[NOTE]
+====
+`autocorrect_service_url` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}].
+====
 
 *Type:* `+String+`
 
diff --git a/modules/ROOT/partials/configuration/automatic_uploads.adoc b/modules/ROOT/partials/configuration/automatic_uploads.adoc
@@ -3,7 +3,10 @@
 
 Enable or disable automatic upload of images represented by data URLs or blob URIs. Such images get generated, for example, as a result of image manipulation through the xref:editimage.adoc[Image Editing] plugin, or after image is drag-n-dropped onto the editor from the desktop.
 
-NOTE: This option will do nothing if `+images_upload_url+` or `+images_upload_handler+` is not specified.
+[NOTE]
+====
+This option will do nothing if `+images_upload_url+` or `+images_upload_handler+` is not specified.
+====
 
 *Type:* `+Boolean+`
 
diff --git a/modules/ROOT/partials/configuration/content_css.adoc b/modules/ROOT/partials/configuration/content_css.adoc
@@ -7,7 +7,10 @@ The `+content_css+` option loads the specified CSS files into the editable area.
 
 *Default value:* `+['default']+` for classic mode, `+[]+` for inline mode
 
-NOTE: This option is intended for use with {productname}'s classic mode, as the editable area is sandboxed within an iframe. For inline mode editors, relevant CSS stylesheets should be loaded as part of the webpage {productname} is rendered in, not using the `+content_css+` option.
+[NOTE]
+====
+This option is intended for use with {productname}'s classic mode, as the editable area is sandboxed within an iframe. For inline mode editors, relevant CSS stylesheets should be loaded as part of the webpage {productname} is rendered in, not using the `+content_css+` option.
+====
 
 include::partial$misc/shipped-content-css.adoc[]
 
diff --git a/modules/ROOT/partials/configuration/content_style.adoc b/modules/ROOT/partials/configuration/content_style.adoc
@@ -7,7 +7,10 @@ This option allows custom CSS styles to be set as a string. The styles are injec
 
 *Default value:* `+undefined+`
 
-NOTE: `+content_style+` styles are not saved within {productname}'s content. If they are needed for display purposes, ensure the styles are also included in the page the content will be displayed on.
+[NOTE]
+====
+`+content_style+` styles are not saved within {productname}'s content. If they are needed for display purposes, ensure the styles are also included in the page the content will be displayed on.
+====
 
 === Example: applying one CSS style using `+content_style+`
 
diff --git a/modules/ROOT/partials/configuration/dialog_persistent.adoc b/modules/ROOT/partials/configuration/dialog_persistent.adoc
@@ -11,7 +11,10 @@ Setting the property to `+true+` does not over-ride normal mechanisms for closin
 
 The property has a default value of `+false+`.
 
-NOTE: If an inline dialog is open and focus is switched away from the {productname} editor entirely (for example, by the end-user switching focus to an available host-browser UI element), an open inline dialog will remain open regardless of the `+persistent+` property's value. This was the behavior prior to this property being available and continues to be the behavior.
+[NOTE]
+====
+If an inline dialog is open and focus is switched away from the {productname} editor entirely (for example, by the end-user switching focus to an available host-browser UI element), an open inline dialog will remain open regardless of the `+persistent+` property's value. This was the behavior prior to this property being available and continues to be the behavior.
+====
 
 *Type:* `+Boolean+`
 
diff --git a/modules/ROOT/partials/configuration/doctype.adoc b/modules/ROOT/partials/configuration/doctype.adoc
@@ -3,7 +3,10 @@
 
 Set the `+doctype+` for the editing area.
 
-WARNING: Changing the `+doctype+` can have different effects on different browsers and may introduce quirks. Use this feature only if you know what you are doing. For more information on doctypes, refer to https://www.w3.org/wiki/Doctypes_and_markup_styles[W3C - Doctypes and markup styles].
+[WARNING]
+====
+Changing the `+doctype+` can have different effects on different browsers and may introduce quirks. Use this feature only if you know what you are doing. For more information on doctypes, refer to https://www.w3.org/wiki/Doctypes_and_markup_styles[W3C - Doctypes and markup styles].
+====
 
 *Type:* `+String+`
 
diff --git a/modules/ROOT/partials/configuration/editable_root.adoc b/modules/ROOT/partials/configuration/editable_root.adoc
@@ -5,7 +5,10 @@ This option sets the initial editable state of a {productname} instance's root.
 
 Setting `editable_root` to `+false+` sets the {productname} root to non-editable (in effect, read-only).
 
-NOTE: a {productname} root set as not-editable can contain child elements with the `contenteditable="true"` attribute set. And these child elements remain editable even when `editable_root: false` is set.
+[NOTE]
+====
+a {productname} root set as not-editable can contain child elements with the `contenteditable="true"` attribute set. And these child elements remain editable even when `editable_root: false` is set.
+====
 
 *Type:* `+Boolean+`
 
diff --git a/modules/ROOT/partials/configuration/end_container_on_empty_block.adoc b/modules/ROOT/partials/configuration/end_container_on_empty_block.adoc
@@ -13,7 +13,10 @@ This option specifies how the current container block element is split when the
 
 *Default value:* `+'blockquote'+`
 
-NOTE: Prior to {productname} 6.1, this option only accepted `+Boolean+` values.
+[NOTE]
+====
+Prior to {productname} 6.1, this option only accepted `+Boolean+` values.
+====
 
 === Example: using `+end_container_on_empty_block+`
 
diff --git a/modules/ROOT/partials/configuration/extended_valid_elements.adoc b/modules/ROOT/partials/configuration/extended_valid_elements.adoc
@@ -25,7 +25,10 @@ Also see xref:content-filtering.adoc#valid_elements[valid_elements] and xref:con
 
 === Using extended_valid_elements to allow script elements
 
-WARNING: Allowing script elements (`+<script>+`) in {productname} exposes users to https://developer.mozilla.org/en-US/docs/Glossary/Cross-site_scripting[cross-site scripting (XSS) attacks].
+[WARNING]
+====
+Allowing script elements (`+<script>+`) in {productname} exposes users to https://developer.mozilla.org/en-US/docs/Glossary/Cross-site_scripting[cross-site scripting (XSS) attacks].
+====
 
 To allow script elements in the editor, include the following in the {productname} configuration:
 
diff --git a/modules/ROOT/partials/configuration/file_picker_callback.adoc b/modules/ROOT/partials/configuration/file_picker_callback.adoc
@@ -13,7 +13,10 @@ It should be noted, that we only provide a hook. It is up to you to implement sp
 
 *Default value:* `+undefined+`
 
-NOTE: The following example demonstrates how you can use `+file_picker_callback+` API, but doesn't pick any real files. Check the xref:interactive-example[Interactive example] for a more functional example.
+[NOTE]
+====
+The following example demonstrates how you can use `+file_picker_callback+` API, but doesn't pick any real files. Check the xref:interactive-example[Interactive example] for a more functional example.
+====
 
 === Example: using `+file_picker_callback+`
 
diff --git a/modules/ROOT/partials/configuration/font_css.adoc b/modules/ROOT/partials/configuration/font_css.adoc
@@ -5,13 +5,19 @@ The `+font_css+` option loads the specified font CSS files into both the editabl
 
 Font CSS files should only contain CSS for specifying custom fonts using the `+@font-face+` and related CSS rules.
 
-NOTE: To allow users to apply the fonts added though `+font_css+`, update the fonts list using the xref:user-formatting-options.adoc#font_family_formats[`+font_family_formats+` option].
+[NOTE]
+====
+To allow users to apply the fonts added though `+font_css+`, update the fonts list using the xref:user-formatting-options.adoc#font_family_formats[`+font_family_formats+` option].
+====
 
 *Type:* `+String+`, `+Array+` of `+Strings+`
 
 *Default value:* `+[]+`
 
-NOTE: This option is intended for use with {productname}'s classic mode, as the editable area is sandboxed within an iframe. For inline mode editors, relevant font CSS files should be loaded as part of the webpage {productname} is rendered in, not using the `+font_css+` option.
+[NOTE]
+====
+This option is intended for use with {productname}'s classic mode, as the editable area is sandboxed within an iframe. For inline mode editors, relevant font CSS files should be loaded as part of the webpage {productname} is rendered in, not using the `+font_css+` option.
+====
 
 If a relative path is specified, it will be resolved in relation to the URL of the webpage {productname} is rendered in.
 
diff --git a/modules/ROOT/partials/configuration/font_size_input_default_unit.adoc b/modules/ROOT/partials/configuration/font_size_input_default_unit.adoc
@@ -11,7 +11,10 @@ Numbers entered in the `fontsizeinput` toolbar without a qualifying unit of meas
 
 *Default value:* `+pt+`
 
-NOTE: If `font_size_input_default_unit` is set to an invalid value (ie, any string other than one of the *possible values* listed above), the setting is ignored. In such a case, numbers entered in the `fontsizeinput` toolbar without a qualifying unit of measure are also ignored.
+[NOTE]
+====
+If `font_size_input_default_unit` is set to an invalid value (ie, any string other than one of the *possible values* listed above), the setting is ignored. In such a case, numbers entered in the `fontsizeinput` toolbar without a qualifying unit of measure are also ignored.
+====
 
 
 === Example: using `+font_size_input_default_unit+`
diff --git a/modules/ROOT/partials/configuration/forced_root_block.adoc b/modules/ROOT/partials/configuration/forced_root_block.adoc
@@ -5,7 +5,10 @@ This option enables you to adjust the default block element used to wrap non blo
 
 To avoid block elements in content, use the xref:content-behavior-options.adoc#newline_behavior[newline_behavior] setting to change what happens when kbd:[Enter] is pressed.
 
-WARNING: Not using `+p+` elements as the root block will impair the functionality of the editor.
+[WARNING]
+====
+Not using `+p+` elements as the root block will impair the functionality of the editor.
+====
 
 *Type:* `+String+`
 
diff --git a/modules/ROOT/partials/configuration/format_noneditable_selector.adoc b/modules/ROOT/partials/configuration/format_noneditable_selector.adoc
@@ -9,7 +9,10 @@ Wrappable formats include block formats that have the `wrapper` parameter set to
 
 Selector formats are not supported.
 
-NOTE: Elements with `contenteditable="false"` attributes that contain descendant elements with `contenteditable="true"` attributes are not wrappable.
+[NOTE]
+====
+Elements with `contenteditable="false"` attributes that contain descendant elements with `contenteditable="true"` attributes are not wrappable.
+====
 
 *Type:* `+String+`
 
diff --git a/modules/ROOT/partials/configuration/fullscreen_native.adoc b/modules/ROOT/partials/configuration/fullscreen_native.adoc
@@ -2,7 +2,10 @@
 == `+fullscreen_native+`
 
 ifeval::["{plugincode}" != "fullscreen"]
-NOTE: The `+fullscreen_native+` option requires the Fullscreen plugin.
+[NOTE]
+====
+The `+fullscreen_native+` option requires the Fullscreen plugin.
+====
 endif::[]
 
 The `+fullscreen_native+` option allows the editor to use the browser full screen mode, rather than only filling the https://developer.mozilla.org/en-US/docs/Web/CSS/Viewport_concepts#What_is_a_viewport[browser window] when full screen mode is enabled. This functionality is the same as full screen mode for online videos.
diff --git a/modules/ROOT/partials/configuration/height.adoc b/modules/ROOT/partials/configuration/height.adoc
@@ -3,7 +3,10 @@
 
 `+height+` sets the height of the entire editor, including the menu bar, toolbars, and status bar.
 
-NOTE: If a number is provided, {productname} sets the height in pixels. If a string is provided, {productname} assumes the value is valid CSS and sets the editor's height as the string value. This allows for alternate units such as `+%+`, `+em+`, and `+vh+`.
+[NOTE]
+====
+If a number is provided, {productname} sets the height in pixels. If a string is provided, {productname} assumes the value is valid CSS and sets the editor's height as the string value. This allows for alternate units such as `+%+`, `+em+`, and `+vh+`.
+====
 
 *Type:* `+Number+` or `+String+`
 
diff --git a/modules/ROOT/partials/configuration/image_cors_hosts.adoc b/modules/ROOT/partials/configuration/image_cors_hosts.adoc
@@ -11,9 +11,15 @@ The {pluginname} plugin cannot work with images from another domain due to secur
 
 An array of supported domains for the images (with CORS enabled on them) can be supplied to {productname} via the `{plugincode}_cors_hosts` option.
 
-NOTE: Each string in the array _must_ be in the format of `+example.com+`. Do not include protocols (for example, `+http://, https://+`) or any trailing slashes in your domains.
-
-NOTE: `{plugincode}_cors_hosts` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}].
+[NOTE]
+====
+Each string in the array _must_ be in the format of `+example.com+`. Do not include protocols (for example, `+http://, https://+`) or any trailing slashes in your domains.
+====
+
+[NOTE]
+====
+`{plugincode}_cors_hosts` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}].
+====
 
 *Type:* `+Array+`
 
diff --git a/modules/ROOT/partials/configuration/image_proxy.adoc b/modules/ROOT/partials/configuration/image_proxy.adoc
@@ -13,7 +13,10 @@ endif::[]
 
 This option can be used as a way of editing images across domains using a third-party local server-side proxy. A proxy is a script, that will retrieve a remote image and pipe it back to {productname}, as if it was an image hosted on the same domain.
 
-NOTE: `{proxy_setting_name}` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}]. If using the self-hosted Java proxy service provided as part of Paid {productname} subscriptions, use the xref:{plugincode}.adoc#{proxy_service_setting_name}[`{proxy_service_setting_name}`] option instead.
+[NOTE]
+====
+`{proxy_setting_name}` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}]. If using the self-hosted Java proxy service provided as part of Paid {productname} subscriptions, use the xref:{plugincode}.adoc#{proxy_service_setting_name}[`{proxy_service_setting_name}`] option instead.
+====
 
 *Type:* `+String+`
 
diff --git a/modules/ROOT/partials/configuration/image_proxy_service_url.adoc b/modules/ROOT/partials/configuration/image_proxy_service_url.adoc
@@ -13,7 +13,10 @@ endif::[]
 
 This option configures the URL to the server-side proxy service which allows remote images hosted on different domains to be retrieved by the {pluginname} plugin. If a proxy is not configured, then remote images may not be able to be {plugin_proxy_action}. Check the xref:introduction-to-premium-selfhosted-services.adoc[Install Server-side Components] guide for details on configuring the self-hosted Java proxy service.
 
-NOTE: `{proxy_setting_name}` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}].
+[NOTE]
+====
+`{proxy_setting_name}` is *not* required when enabling this plugin via xref:editor-and-features.adoc[{cloudname}].
+====
 
 *Type:* `+String+`
 
diff --git a/modules/ROOT/partials/configuration/init_content_sync.adoc b/modules/ROOT/partials/configuration/init_content_sync.adoc
@@ -11,7 +11,10 @@ When enabled, the editor is initialized synchronously, using `document.write`. T
 
 Flickering can still occur during synchronous initialization, however, such as when loading the content CSS.
 
-NOTE: using the https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html#document.write()[`document.write`] method is https://developer.mozilla.org/en-US/docs/Web/API/Document/write[strongly discouraged].
+[NOTE]
+====
+using the https://html.spec.whatwg.org/multipage/dynamic-markup-insertion.html#document.write()[`document.write`] method is https://developer.mozilla.org/en-US/docs/Web/API/Document/write[strongly discouraged].
+====
 
 *Type:* `+Boolean+`
 
@@ -29,4 +32,7 @@ tinymce.init({
 });
 ----
 
-NOTE: When {productname} is running in xref:use-tinymce-inline.adoc[inline mode] (ie, when `+inline: true+` is set), setting `init_content_sync: true` has no effect.
+[NOTE]
+====
+When {productname} is running in xref:use-tinymce-inline.adoc[inline mode] (ie, when `+inline: true+` is set), setting `init_content_sync: true` has no effect.
+====
diff --git a/modules/ROOT/partials/configuration/inline.adoc b/modules/ROOT/partials/configuration/inline.adoc
@@ -23,7 +23,10 @@ tinymce.init({
 });
 ----
 
-NOTE: {productname} in inline mode will not initialize on the following elements: `+area+`, `+base+`, `+basefont+`, `+br+`, `+col+`, `+frame+`, `+hr+`, `+img+`, `+input+`, `+isindex+`, `+link+`, `+meta+`, `+param+`, `+embed+`, `+source+`, `+wbr+`, `+track+`, `+colgroup+`, `+option+`, `+table+`, `+tbody+`, `+tfoot+`, `+thead+`, `+tr+`, `+th+`, `+td+`, `+script+`, `+noscript+`, `+style+`, `+textarea+`, `+video+`, `+audio+`, `+iframe+`, `+object+`, and `+menu+`.
+[NOTE]
+====
+{productname} in inline mode will not initialize on the following elements: `+area+`, `+base+`, `+basefont+`, `+br+`, `+col+`, `+frame+`, `+hr+`, `+img+`, `+input+`, `+isindex+`, `+link+`, `+meta+`, `+param+`, `+embed+`, `+source+`, `+wbr+`, `+track+`, `+colgroup+`, `+option+`, `+table+`, `+tbody+`, `+tfoot+`, `+thead+`, `+tr+`, `+th+`, `+td+`, `+script+`, `+noscript+`, `+style+`, `+textarea+`, `+video+`, `+audio+`, `+iframe+`, `+object+`, and `+menu+`.
+====
 
 For more information on the differences between the editing modes, please see this page xref:use-tinymce-inline.adoc[here].
 
diff --git a/modules/ROOT/partials/configuration/link_context_toolbar.adoc b/modules/ROOT/partials/configuration/link_context_toolbar.adoc
@@ -3,7 +3,10 @@
 
 By default it is not possible to open links directly from the editor. Setting `+link_context_toolbar+` to `+true+` will enable a context toolbar that will appear when the user's cursor is within a link. This context toolbar contains fields to modify, remove and open the selected link. External links will be opened in a separate tab, while relative links scroll to a target within the editor (if the target is found).
 
-NOTE: This context toolbar is the same as the context toolbar mentioned in the xref:link.adoc#link_quicklink[Link plugin - `+link_quicklink+`] documentation.
+[NOTE]
+====
+This context toolbar is the same as the context toolbar mentioned in the xref:link.adoc#link_quicklink[Link plugin - `+link_quicklink+`] documentation.
+====
 
 *Type:* `+Boolean+`
 
diff --git a/modules/ROOT/partials/configuration/link_quicklink.adoc b/modules/ROOT/partials/configuration/link_quicklink.adoc
@@ -3,7 +3,10 @@
 
 This option changes the behaviour of the kbd:[Ctrl+K] shortcut. By default, pressing kbd:[Ctrl+K] will open the link dialog. If `+link_quicklink+` is set to `+true+`, pressing kbd:[Ctrl+K] will instead open the link context toolbar. If the cursor is within an existing link, this context toolbar will contain fields for modifying, removing and opening the selected link. If not, the context toolbar allows for the quick insertion of a link.
 
-NOTE: This context toolbar is the same as the context toolbar mentioned in the xref:link.adoc#link_context_toolbar[`+link_context_toolbar+`] documentation above.
+[NOTE]
+====
+This context toolbar is the same as the context toolbar mentioned in the xref:link.adoc#link_context_toolbar[`+link_context_toolbar+`] documentation above.
+====
 
 *Type:* `+Boolean+`
 
diff --git a/modules/ROOT/partials/configuration/max_height.adoc b/modules/ROOT/partials/configuration/max_height.adoc
@@ -32,4 +32,7 @@ tinymce.init({
 ----
 endif::[]
 
-NOTE: If the xref:editor-size-options.adoc#resize[`+resize+`] option is set to `+false+` the resize handle will be disabled and a user will not be able to resize the editor (by manual dragging). Note that `+resize+` defaults to `+false+` when the `+autoresize+` plugin is enabled.
+[NOTE]
+====
+If the xref:editor-size-options.adoc#resize[`+resize+`] option is set to `+false+` the resize handle will be disabled and a user will not be able to resize the editor (by manual dragging). Note that `+resize+` defaults to `+false+` when the `+autoresize+` plugin is enabled.
+====
diff --git a/modules/ROOT/partials/configuration/max_width.adoc b/modules/ROOT/partials/configuration/max_width.adoc
@@ -3,7 +3,10 @@
 
 This option sets the maximum width that a user can stretch the entire {productname} interface (by grabbing the draggable area in the bottom right of the editor interface).
 
-NOTE: This behavior is different than the xref:autoresize.adoc[`+autoresize+`] plugin, which controls the resizing of the editable area only, not the entire editor.
+[NOTE]
+====
+This behavior is different than the xref:autoresize.adoc[`+autoresize+`] plugin, which controls the resizing of the editable area only, not the entire editor.
+====
 
 *Type:* `+Number+`
 
@@ -19,4 +22,7 @@ tinymce.init({
 });
 ----
 
-NOTE: by default the xref:editor-size-options.adoc#resize[`+resize+`] handle does not allow horizontal dragging and giving this key a value will not result in an observable behavior.
+[NOTE]
+====
+by default the xref:editor-size-options.adoc#resize[`+resize+`] handle does not allow horizontal dragging and giving this key a value will not result in an observable behavior.
+====
diff --git a/modules/ROOT/partials/configuration/min_height.adoc b/modules/ROOT/partials/configuration/min_height.adoc
@@ -32,4 +32,7 @@ tinymce.init({
 ----
 endif::[]
 
-NOTE: If the xref:editor-size-options.adoc#resize[`+resize+`] option is set to `+false+` the resize handle will be disabled and a user will not be able to resize the editor (by manual dragging). Note that `+resize+` defaults to `+false+` when the `+autoresize+` plugin is enabled.
+[NOTE]
+====
+If the xref:editor-size-options.adoc#resize[`+resize+`] option is set to `+false+` the resize handle will be disabled and a user will not be able to resize the editor (by manual dragging). Note that `+resize+` defaults to `+false+` when the `+autoresize+` plugin is enabled.
+====
diff --git a/modules/ROOT/partials/configuration/min_width.adoc b/modules/ROOT/partials/configuration/min_width.adoc
diff --git a/modules/ROOT/partials/configuration/newline_behavior.adoc b/modules/ROOT/partials/configuration/newline_behavior.adoc
diff --git a/modules/ROOT/partials/configuration/noneditable_regexp.adoc b/modules/ROOT/partials/configuration/noneditable_regexp.adoc
diff --git a/modules/ROOT/partials/configuration/powerpaste_autolink_urls.adoc b/modules/ROOT/partials/configuration/powerpaste_autolink_urls.adoc
diff --git a/modules/ROOT/partials/configuration/smart_paste.adoc b/modules/ROOT/partials/configuration/smart_paste.adoc
diff --git a/modules/ROOT/partials/configuration/spellchecker_on_load.adoc b/modules/ROOT/partials/configuration/spellchecker_on_load.adoc
diff --git a/modules/ROOT/partials/configuration/spellchecker_rpc_url.adoc b/modules/ROOT/partials/configuration/spellchecker_rpc_url.adoc
diff --git a/modules/ROOT/partials/configuration/table_grid.adoc b/modules/ROOT/partials/configuration/table_grid.adoc
diff --git a/modules/ROOT/partials/configuration/target.adoc b/modules/ROOT/partials/configuration/target.adoc
diff --git a/modules/ROOT/partials/configuration/toolbar.adoc b/modules/ROOT/partials/configuration/toolbar.adoc
diff --git a/modules/ROOT/partials/configuration/toolbar_sticky_offset.adoc b/modules/ROOT/partials/configuration/toolbar_sticky_offset.adoc
diff --git a/modules/ROOT/partials/configuration/width.adoc b/modules/ROOT/partials/configuration/width.adoc
