[jboss-jira] [JBoss JIRA] (WFLY-9744) Improve Infinispan subsystem model descriptions

Radoslav Husar (JIRA) issues at jboss.org
Wed Feb 7 06:43:00 EST 2018


     [ https://issues.jboss.org/browse/WFLY-9744?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Radoslav Husar updated WFLY-9744:
---------------------------------
    Description: 
In order to not duplicate documentation in docs/ and wildscribe, we will link from documentation to wildscribe. This requires descriptions to be improved. The descriptions:

* should describe behavior
* should avoid using domain model terminology (e.g. attributes, child)
* take out the redundant verb such as 'configures' (unless appropriate, e.g. in operation desc.)

Upon completion, we can remove the sections from documentation and link.

  was:
In order not to duplicate documentation in docs/ and wildscribe, we can link from documentation to wildscribe.

* the descriptions should avoid using domain model terminology (e.g. attributes, child)
* should describe behavior
* take out the redundant verb (unless appropriate, e.g. in operation desc.)



> Improve Infinispan subsystem model descriptions 
> ------------------------------------------------
>
>                 Key: WFLY-9744
>                 URL: https://issues.jboss.org/browse/WFLY-9744
>             Project: WildFly
>          Issue Type: Task
>          Components: Clustering
>            Reporter: Radoslav Husar
>            Assignee: Paul Ferraro
>
> In order to not duplicate documentation in docs/ and wildscribe, we will link from documentation to wildscribe. This requires descriptions to be improved. The descriptions:
> * should describe behavior
> * should avoid using domain model terminology (e.g. attributes, child)
> * take out the redundant verb such as 'configures' (unless appropriate, e.g. in operation desc.)
> Upon completion, we can remove the sections from documentation and link.



--
This message was sent by Atlassian JIRA
(v7.5.0#75005)


More information about the jboss-jira mailing list