GS/Params & Metrics: review (2.0)

[jorgeorpinel]

https://katacoda.com/dvc/courses/get-started/params-metrics-plots

• "experiments", "experimentation" - Not sure we want to introduce the concept of "experiments" since there's a special meaning in 2.0 (https://dvc.org/doc/start/experiments)

Intro

• THE Data science process
• "try many different approaches, different hyper-parameter values" -> "try different approaches, hyper-parameters"

Step 1:

• "In the previous scenario" - I don't think we want there to be a chronological connection between scenarios. They should be independent (but you can link to it or to the actual Get Started docs). Let's just explain all the basics again (very very summarized)
• "using the link below:" - Skip (it's intuitive to click on the link below)
• "In this scenario" - This phrase is repeated multiple times (may not need it at all but if so just once is enough)
• "first-class support" - cool phrase, what does it mean? Curious
• "and run the affected stages" -> "and reproduce the affected stages"
• "However, these" -> "These"
• "with the stages" -> "with their stages"
• "begin by reproducing the pipeline without parameters" - A bit confusing since we open with "The programs that run these stages already have parameter definitions" (feels contradictory)
• dvc repro -OK but cat dvc.yaml first?
• git add data/.gitignore dvc.yaml data/prepared/ dvc.lock - only needs data/.gitignore dvc.lock

Steps 2:

• "tracks them as another factor in stages" -> "tracks them as part of the stage definitions" ?
• "their own block params" -> "their own params block"
• "You can view dvc.yaml by clicking..." - Skip this whole paragraph
• Adding the params blocks (very cool) inserts and extra empty new line that makes it the file less readable (avoid)
• "(You can quit from diff by pressing q)" - Use git --no-pager diff to avoid this sentence.
• "retrieved them" -> retrieves
• "begin tracking" -> "begins tracking them"
• "As the last step, we add" -> "Let's add"

Step 3:

• "In this step, we'll see how" - Could skip this whole paragraph (just another example of minimizing text)

[WIP 😅]