You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ignite.apache.org by "Andrey N. Gura (Jira)" <ji...@apache.org> on 2021/08/31 15:10:00 UTC

[jira] [Updated] (IGNITE-15410) CLI: cli module internal documentation is obsolete

     [ https://issues.apache.org/jira/browse/IGNITE-15410?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Andrey N. Gura updated IGNITE-15410:
------------------------------------
    Description: 
Internal documentation for {{cli}} module which represented by {{modules/cli/README.md}} file is obsolete.

It seems that internal documentation of {{cli}} module should be developer oriented and should not consist of list of possible commands. Instead it should describe module design and 'How to' sections which describe how new commands, arguments, etc could be added.

Also it makes sense to add reference to user oriented document which describes Ignite CLI commands: {{docs/_docs/ignite-cli-tool.adoc}}

  was:
Internal documentation for {{cli}} module which represented by {{modules/cli/README.md}} file is obsolete.

It seems that internal documentation of {{cli}} module should be developer oriented and should not consist of list of possible commands. Instead it should describe module design and 'How to' sections which describe how new commands, arguments, etc could be added.


> CLI: cli module internal documentation is obsolete
> --------------------------------------------------
>
>                 Key: IGNITE-15410
>                 URL: https://issues.apache.org/jira/browse/IGNITE-15410
>             Project: Ignite
>          Issue Type: Bug
>            Reporter: Andrey N. Gura
>            Priority: Major
>              Labels: ignite-3, internal-doc
>
> Internal documentation for {{cli}} module which represented by {{modules/cli/README.md}} file is obsolete.
> It seems that internal documentation of {{cli}} module should be developer oriented and should not consist of list of possible commands. Instead it should describe module design and 'How to' sections which describe how new commands, arguments, etc could be added.
> Also it makes sense to add reference to user oriented document which describes Ignite CLI commands: {{docs/_docs/ignite-cli-tool.adoc}}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)