Support for local development about oscal-reference

[nikitawootten-nist]

Hey Chris, there is actually a simpler way to work around this. Makefile variables can be overridden, so instead of editing list_revisions.sh you can just override the variable its result is stored in:

$ make site REVISIONS="v1.1.0 my-test-branch my-other-test-branch"

This behavior is a bit unexpected. I agree it should be documented somewhere.

[Compton-US]

Thanks. I need to make another feature branch this afternoon and start work, so I'll reset and try this out.

[nikitawootten-nist]

As for pointing at alternative OSCAL source repositories, currently you would have to edit the generate_modeldoc.sh script, but the script could be edited to either:

1. Accept an environment variable to override the OSCAL source directory
2. Expect the OSCAL source directory to be passed in as an argument, so that it would also be controlled via the Makefile

The ladder has some interesting properties, such as allowing the Makefile to ensure the user has initialized the submodule (unless it has been overridden).

[Compton-US]

This approach seems to be working for me. I've adjusted the generate_modeldoc script and Makefile to support the local OSCAL repo part, and I'll push it up as a feature branch sometime today for consideration. I need to add something to the readme on how to use.

[nikitawootten-nist]

This approach seems to be working for me. I've adjusted the generate_modeldoc script and Makefile to support the local OSCAL repo part, and I'll push it up as a feature branch sometime today for consideration. I need to add something to the readme on how to use.

Awesome, if possible I'd like to also amend the script to optionally not use a worktree (just use the provided oscal folder without making a temporary copy)

[iMichaela]

The solution indicated by @nikitawootten-nist needs to be tested and documented in the README with examples of how to:

1. override the REVISION to generate the documentation for a single branch or a selected list of branches (releases or prototypes) 2.
2. pointing at alternative OSCAL source repositories by editing the generate_modeldoc.sh script.

Alternatively, the script can be modified under this issue, to accept an environment variable to override the OSCAL source directory
OR to expect the OSCAL source directory to be passed in as an argument, so that it would also be controlled via the Makefile