Add code regions

[samfreund]

Code regions will allow us to reference code from a file utilizing specific tags embedded in the file. This is superior to referencing by line, as is common with RLI's, as this is resistant to changes.

Usage is by adding a comment with the region name in square-brackets. See below for an example.

// [pickme]
int foo = 12;

int bar = 29;

System.out.println(foo + bar);

// [/pickme]

[github-actions]

🌐 Preview URL: https://pr-48.frcsoftware.pages.dev

[roboteer5291]

Should format:check be listed here too?

[roboteer5291]

Mostly good, see one comment + general disagreement with stg0, keep it simple and make it stage 0

[DylanB5402]

Code generally looks good, a couple higher level questions, but nothing holding back approval:

• Is there an example of what RLIs actually look like in use somewhere on the PR preview?
• Any reason we're writing our own plugin here? Not sure if there's already something out there that does what we need

[samfreund]

Code generally looks good, a couple higher level questions, but nothing holding back approval:

• Is there an example of what RLIs actually look like in use somewhere on the PR preview?
• Any reason we're writing our own plugin here? Not sure if there's already something out there that does what we need

Nothing out there that suits our purposes that's actually maintained. I implemented the RLIs for the Java fundamentals, so you can just peek at that.

[Daniel1464]

I think that it would be better for the snippets to be in a separate folder than the code solutions. People are probably going to be forking the entire repo to look at solutions. Other than that, though, looks great

[samfreund]

I think that it would be better for the snippets to be in a separate folder than the code solutions. People are probably going to be forking the entire repo to look at solutions. Other than that, though, looks great

We need to compile the entirety of the code to validate the snippets. That would mean maintaining two copies of the solutions, and I don't think that's viable. IMO, the snippets are easily ignorable, but if we must we can take the same strategy we'll be using with the templates and strip the snippets via copybara to a separate repo.

[roboteer5291]

Additionally, most snippets will be in the solution code, which won't need to be cloned as part of the course.