codelabs icon indicating copy to clipboard operation
codelabs copied to clipboard

It is far too hard to update the bootcamp codelab

Open aiuto opened this issue 5 years ago • 3 comments

The codelab contains BUILD and WORKSPACE files that have hints rather than real rules. As part of the lab, the user uncomments some parts and fills in others.

There is a tool which creates the fully formed BUILD files, but we need the other direction, so you can instantiate the BUILD, test everything, then revert to the hints for committing.

aiuto avatar Aug 13 '19 16:08 aiuto

The original idea that @dkelmer and I discussed when forming this codelab was to have the repo be empty by default for teaching purposes. I believe there are also codelab materials that assumes this, so those will need to be updated as well.

jin avatar Aug 13 '19 19:08 jin

I think @aiuto is saying that the "initial" state of the codelab from the user perspective (i.e. mostly empty with hints) should be maintained. And I think that this bug is about having a way to alleviate the repository maintainer's burden of updating the repository by adding an additional script that undoes what the generation script generates so that it can be submitted with just the mostly empty BUILD files with the hints.

I imagine that the hints won't change too often. So this should be as simple has having an additional script checked in that reverts what generate_build_files.sh does

dkelmer avatar Aug 13 '19 20:08 dkelmer

I'll mail a PR in a minute

dkelmer avatar Aug 13 '19 20:08 dkelmer