You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@submarine.apache.org by "Byron Hsu (Jira)" <ji...@apache.org> on 2021/07/12 05:18:00 UTC

[jira] [Resolved] (SUBMARINE-921) [User] Refactor User docs

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

Byron Hsu resolved SUBMARINE-921.
---------------------------------
    Fix Version/s: 0.7.0
       Resolution: Fixed

Issue resolved by pull request 662
[https://github.com/apache/submarine/pull/662]

> [User] Refactor User docs
> -------------------------
>
>                 Key: SUBMARINE-921
>                 URL: https://issues.apache.org/jira/browse/SUBMARINE-921
>             Project: Apache Submarine
>          Issue Type: Sub-task
>            Reporter: Byron Hsu
>            Assignee: Byron Hsu
>            Priority: Major
>              Labels: pull-request-available
>             Fix For: 0.7.0
>
>
> h3. Changes
> Old:
> {code:java}
> .
> └── Users Docs/
>     ├── Submarine on Kubernetes/
>     │   └── ...
>     ├── Submarine on Yarn/
>     │   └── ...
>     ├── Submarine SDK/
>     │   └── ...
>     └── Submarine Security/
>         └── ...
> {code}
> New:
> {code:java}
> .
> └── Users Docs/
>     ├── API documentation/
>     │   ├── Experiment REST API
>     │   ├── Experiment Template REST API
>     │   ├── Environment REST API
>     │   └── Notebook REST API
>     └── Submarine SDK/
>         ├── Experiment Client
>         ├── Model Client
>         └── Tracking (deprecated)
>     ├── Submarine Security/
>     │   └── ...
>     └── Other utilities/
>         └── MLflow UI
>         └── Tensorboard{code}
> h3. Details
> 1. Remove "Submarine on Yarn" because Yarn is deprecated.
>  2. Rename "Submarine on Kubernetes" to "API "documentation", categorized into four classes: "Experiment REST API", "Experiment Template REST API", "Environment REST API", and "Notebook REST API". For each API endpoint, provide spec and examples. (refer to [https://docs.github.com/en/rest/reference/actions])
>  3. Refactor "Submarine-SDK", categorized into three classes: "Experiment Client", "Model Client" and "Tracking". For each class, provide the spec and examples. (refer to [https://mlflow.org/docs/latest/python_api/mlflow.html])
>  4. Add "Other utilities" to provide the details of how to use tensorboard and mlflow UI.
>  5. Keep "Submarine Security" intact.



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

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@submarine.apache.org
For additional commands, e-mail: dev-help@submarine.apache.org