cloudstack-documentation icon indicating copy to clipboard operation
cloudstack-documentation copied to clipboard

Update IPv6 Support page to remove explanation of what an IPv6 address is from introduction

Open mivsvit opened this issue 2 years ago • 4 comments

The characters s and t are not valid hex. Correct the example 5001:0dt8:83a3:1012:1000:8s2e:0870:7454 so that it is a valid IPv6 address. Also change to use the 2001:db8::/32 IPv6 documentation prefix.


📚 Documentation preview 📚: https://cloudstack-documentation--370.org.readthedocs.build/en/370/

mivsvit avatar Dec 20 '23 13:12 mivsvit

@mivsvit do you think we need to add a warning not to use the example (ever)?

DaanHoogland avatar Jan 17 '24 11:01 DaanHoogland

@mivsvit do you think we need to add a warning not to use the example (ever)?

I think better to remove most of that paragraph and just say as an introduction "CloudStack supports IPv6 for shared and isolated networks. It also supports IPv6 for VPC tiers." and leave it at that.

Given the technical level of the content on that page I would suggest it is fair to assume the reader should know already what an IPv6 address is. There are already examples of IPv6 CIDRs as appropriate later on that page.

And other parts of that introduction are not great - for example, although IPv6 has been slow to be adopted, it's been around for decades, it is not "recent" and it is not a good definition of IP that it "defines routing the network traffic".

mivsvit avatar Jan 17 '24 11:01 mivsvit

sounds good, would you extend your PR for this, @mivsvit ?

DaanHoogland avatar Jan 17 '24 12:01 DaanHoogland

@alexandremattioli would you agree?

DaanHoogland avatar Jan 17 '24 13:01 DaanHoogland