Replacing existing AWS_CloudFormation_Template_Reference

[tmclaugh]

Hi, the existing AWS CFN docset has grown out of date. I attempted to update it but the generation script was written for a much older version of node which lead me to do a complete rewrite. I've gotten permission from the original docset author to replace his. in pdhodgkinson/AWSCloudFormationTemplateReference-dash-docset#22

Besides updating the documentation I've also:

• Added section anchors in pages
• Used the AWS site CSS for a native look at feel
• Added syntax highlighting
• Can now browse by both AWS CFN resources (AWS::Service::Resource) or AWS service names

Because this is a large rewrite by a new person how should I handle adding it? I also made a change to the DocSetPlatformFamily so it was much shorter.

My latest release can be found here.

https://github.com/ServerlessOpsIO/dash-docset-aws-cloudformation/releases/tag/20241104.01

[tmclaugh]

I also have one issue. in this dropdown I'm not sure where the smaller lighter text is from and why sometimes it just says "AWS". How do I fix this?

[Kapeli]

Because this is a large rewrite by a new person how should I handle adding it?

You can submit a pull request that includes the update.

I also have one issue. in this dropdown I'm not sure where the smaller lighter text is from and why sometimes it just says "AWS". How do I fix this?

That text is taken from the file name of the docs page by default. You can disable it by adding this in Info.plist: <key>DashDocSetDeclaredInStyle</key><string>originalName</string>.

You can customize it for each entry by adding this anywhere in the path of the entry (in docSet.dsidx): <dash_entry_menuDescription=#percent_encoded_value#>

[tmclaugh]

Hi, but am I replacing the existing docset directory with a new one or using the existing directory?

[Kapeli]

Update the existing directory