[Epic] Add more content to the docs (help wanted)

[blairdrummond]

I'd like some help on the docs, if you guys don't mind. If you just submit your comments in this issue I can add that content and format it nicely.

• @chritter : can you help with https://github.com/StatCan/daaas/blob/master/docs/1-Experiments/MLflow.md

• @frazs : can you help with https://github.com/StatCan/daaas/blob/master/docs/1-Experiments/ML-Workspaces.md

• @ca-scribner : can you help with https://github.com/StatCan/daaas/blob/master/docs/1-Experiments/Databricks.md

• @brendangadd : can you help me out with https://github.com/StatCan/daaas/blob/master/docs/Help.md

• @zachomedia : can you provide some input on https://github.com/StatCan/daaas/blob/master/docs/Storage.md#programmatic-access
  Specifically, I don't quite understand our vault integration with the buckets. I can write up the rest if you explain how get the secret and access keys for programmatic access. Do I just have to source something then we're off-to-the-races? Do the keys ever change? Done.

Original Epic Issues

• Document that users should not pass secrets to kubeflow pipelines via environment variables #91 Warn that users should not pass secrets by environment variable to kfp
• Add overview of Kubeflow Pipelines to docs #92 Add overview of kfp to docs
• Add/document base images for users to use #53 Add/document base images for users
• Add Lightweight Pipelines to KFP Docs #109 Add lightweight pipelines to KFP docs
• Add passing data to/from KFP pipelines to Docs/other misc KFP instructions #110 Add passing data to/from KFP
• Update "Help/Contact" section of the docs #153 Update "Help/Contact" section of the docs
• Add kfp examples using lightweight and reusable components aaw-contrib-jupyter-notebooks#24 Add KFP examples for lightweight components, reusable components and minio access

Videos

• Advertise our videos ( Advertise our video tutorial series #131 )

Storage

• New Feature: S3 Buckets mounted with Goofys ([Epic] Automatic blob storage access from notebook servers #194 + Volume mount user s3 buckets (and others) on notebook creation #193)
• Clean up storage docs (remove datasets/public, etc)
• Remove the notes about Minio credential injection (Depends on Remove credential-injection from notebook server "Configurations" #196 )

Jupyter

• Tell Users to use Conda to install packages (docs: Tell users to use conda to install packages. #132)
• Document the proxy/port thing ( Document /proxy/$port functionality for app development.  #116 )

R-Shiny+R-Studio

• Add RStudio to docs (Add RStudio to docs #115)
• Shiny deployment/PR process (Update R-Shiny docs #186)

ML-Workspace

• Add ML-Workspace to docs (feat: Add Remote Desktop documentation #117 & depends on landing page )

Misc

• Images are out of date - the portal, kubeflow menu, etc
• Need to add the MLFlow docs (Update MLflow.md #76)
• Remove DataBricks (for now)
• Add Vault UI instructions for creating new MinIO tokens (Add Vault UI to the docs #149)

[chritter]

@blairdrummond I will assign the task to Chatana in my team.

[chetana1995]

Hi, @blairdrummond I would like to contribute on ML flow. But, I couldn't find the document. Could you please provide me with the document

[blairdrummond]

Here it is

https://github.com/StatCan/daaas/blob/master/docs/en/1-Experiments/MLflow.md

To build the site, you'll need mkdocs and mkdocs-material (from pip). Then run

mkdocs build -c -f mkdocs-en.yml
mkdocs serve -f mkdocs-en.yml

And look at localhost:8000

Make sure that you copy your edits over to /fr too. Also, for PRs, we're putting changes in a branch (in your case, make an mlflow branch), and then push that branch up and open a PR to master. (Don't just commit to master)

[brendangadd]

@chetana1995 Please do not modify the French (/fr) content (unless you're comfortable writing in both official languages). We can take care of getting English content translated and adding it to this PR.

/cc @blairdrummond

[chetana1995]

@brendangadd Sure. Currently, I am only modifying English content.

[blairdrummond]

We have a whole bunch of documentation stuff to do. We should try to resolve these tickets.

CC @brendangadd

Videos

• Advertise our videos ( Advertise our video tutorial series #131 )

Storage

• New Feature: S3 Buckets mounted with Goofys ([Epic] Automatic blob storage access from notebook servers #194 + Volume mount user s3 buckets (and others) on notebook creation #193)
• Clean up storage docs (remove datasets/public, etc)
• Remove the notes about Minio credential injection (Depends on Remove credential-injection from notebook server "Configurations" #196 )

Jupyter

• Tell Users to use Conda to install packages (docs: Tell users to use conda to install packages. #132)
• Document the proxy/port thing ( Document /proxy/$port functionality for app development.  #116 )

R-Shiny+R-Studio

• Add RStudio to docs (Add RStudio to docs #115)
• Shiny deployment/PR process (Update R-Shiny docs #186)

ML-Workspace

• Add ML-Workspace to docs (feat: Add Remote Desktop documentation #117 & depends on landing page )

Misc

• Images are out of date - the portal, kubeflow menu, etc
• Need to add the MLFlow docs (Update MLflow.md #76)
• Remove DataBricks (for now)
• Add Vault UI instructions for creating new MinIO tokens (Add Vault UI to the docs #149)

Edited by @brendangadd:

• Copied these tasks to first comment on issue so they are tracked as m of n tasks completed
• Changed this comment's check boxes to bullets to avoid confusion w.r.t. first comment
• Please update task progress via the first comment