Add an optional _FYI key or similar for the persistent properties JSON file

[kevmoo]

If I run into ~/.stagehand and open it

{
  "firstRun": false,
  "enabled": true,
  "clientId": "XYZ..."
}

I may wonder what's going on.

If I saw...

{
  "_FYI": "This file stores Google Analytics settings for https://pub.dartlang.org/packages/stagehand",
  "firstRun": false,
  "enabled": true,
  "clientId": "XYZ..."
}

I'd be much less confused...

[kevmoo]

Thoughts, @devoncarew ?

[devoncarew]

That sounds reasonable. We could also parse and ignore leading # foo lines, and generate the file with a comment:

# This file stores Google Analytics settings for https://pub.dartlang.org/packages/stagehand.

{
  "firstRun": false,
  "enabled": true,
  "clientId": "XYZ..."
}

[devoncarew]

Or, just convert it entirely to a .properties file...

[kevmoo]

Was pondering a solution where we keep backwards compat – and avoid getting into the parser business...

…

On Thu, Apr 19, 2018 at 1:07 PM Devon Carew ***@***.***> wrote: Or, just convert it entirely to a .properties file... — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#122 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AABCip5gHdmVw5WwouztqePXLjiTlX38ks5tqO5zgaJpZM4TcWdg> .

[devoncarew]

closing as we're no longer going to actively work on this package (#195)