Repository navigation
Example Usage Templates #102
Description
Wanted to get some thoughts about maybe adding templates for the Example Usage section, similar to the use of NOTES.md. As it stands now, this action overwrites the Example Usage section each time it runs, which is less than ideal.
I was thinking maybe an EXAMPLES.json file like the following:
{
"optionSets": [
{
"optionOne": "valueOne"
},
{
"optionTwo": "valueTwo"
}
]
}
If this seems agreeable, I could cook up a PR for this, I think.
Reacted by joshspicer
Activity
joshspicer commentedon Nov 16, 2022
That seems super reasonable, thanks for offering to contribute it!
Given the current auto-generated example:
I agree that some file (
EXAMPLES.json) could look something like:...To then generate markdown like:
Example Usage
With a version
With a version and password
joshspicer commentedon Nov 16, 2022
I've also tossed around the idea of putting all of a Feature's default options into the value object, but landed on the empty object for copy/paste simplicity. Effectively, putting all options at the default value resolves to exactly the same as placing nothing.
That said, I like your idea of giving the author the choice. (Could be cool to do some simple validation on the output to ensure those options exist in the
devcontainer-feature.json)