sphinx: Default values aren't shown in docs

[clareliguori]

I'm noticing that the "@default" flag in the code comments is not translating into a default value shown in the docs. From the docs, it reads as though there is no default value, which is confusing.

For example, default value for containerPort (80) in LoadBalancedFargateService:

https://github.com/awslabs/aws-cdk/blob/master/packages/%40aws-cdk/aws-ecs/lib/load-balanced-fargate-service.ts#L62

Is not shown in the docs:

https://awslabs.github.io/aws-cdk/refs/_aws-cdk_aws-ecs.html#@aws-cdk/aws-ecs.LoadBalancedFargateServiceProps.containerPort

[rix0rrr]

And the (abstract), though technically true, doesn't really help either

…

On 7 Nov 2018, at 19:55, Clare Liguori ***@***.***> wrote: I'm noticing that the ***@***.***" flag in the code comments is not translating into a default value shown in the docs. From the docs, it reads as though there is no default value, which is confusing. For example, default value for containerPort (80) in LoadBalancedFargateService: https://github.com/awslabs/aws-cdk/blob/master/packages/%40aws-cdk/aws-ecs/lib/load-balanced-fargate-service.ts#L62 Is not shown in the docs: ***@***.***/aws-ecs.LoadBalancedFargateServiceProps.containerPort — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub, or mute the thread.

[eladb]

Should be fixed in the latest release