Use Visual Studio Construct a Octopus Project
Octopus was born out of a desire to help .NET developers, why not have someone try this...
Create a custom project type for Visual Studio for Octopus Projects that incorporate these json files.
That would allow a GUI that can easily and ready be documented, it would allow us to integrate them with our source control tools, and more closely align our Octopus projects with our work.
I wish I had those skills, I'm more of a DBA/BI Developer, but I think this idea could work, thoughts?