Inconsistencies between official documentation and Resource Specification

[afronski]

Sigh.

We cannot trust entirely Resource Specification from AWS API, because we've already found inconsistencies:

Inconsistent URLs between specification and reality

a) Real URL to docs:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distributionconfig.html#cfn-cloudfront-distributionconfig-defaultcachebehavior

b) URL from specifications:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudfront-distribution-distributionconfig.html#cfn-cloudfront-distribution-distributionconfig-defaultcachebehavior

The one from specifications does not exists 😕 Small difference between those two, but still.

Specs are not up to date in every case

    "AWS::CloudFront::Distribution.DistributionConfig": {
      "Properties": {
        ...
        "DefaultCacheBehavior": {
          "Type": "DefaultCacheBehavior",
          "Required": false,
          "Documentation": "https://...",
          "UpdateType": "Mutable"
        },
      ...
      }
    }

Look at the required property value - false.
And now take a look at the documentation:

DefaultCacheBehavior
The default cache behavior that is triggered if you 
do not specify the CacheBehavior property or if files 
don't match any of the values of PathPattern in 
the CacheBehavior property.

Required: Yes

Type: DefaultCacheBehavior type

When the first one issue is not so big, the second one may cause us some problems, I hope there are not too many inconsistencies like that.

Solution:

We need to create a patching mechanism inside perun that will allow patch in place via code / configuration those exceptions.