NetAppDocs / ontap

https://docs.netapp.com/us-en/ontap/
27 stars 70 forks source link

Laundry list of over 30 links begs the question #1419

Closed adamn-netapp closed 1 month ago

adamn-netapp commented 1 month ago

Page URL

https://docs.netapp.com/us-en/ontap/zero-trust/zero-trust-learn-more.html

Page title

Learn more about ONTAP Zero Trust content

Summary

Why do we present the end user with a list of over 30 links in this topic?

Public issues must not contain sensitive information

netapp-dbagwell commented 1 month ago

@adamn-netapp thanks. I'll consult the author. We can reassess the value of the links as presented.

netapp-ehoffman commented 1 month ago

@adamn-netapp , this is something I should have dealt with before we published, I don't think we'll get much pushback on removing this list from Dan Tulledge. (Many of the links could be presented inline earlier in the doc.)

adamn-netapp commented 1 month ago

Your point about presenting some of these links in the body of the document is well taken, Ed.

I noted that none of the topics have "Related information" sections at the bottom. This make the topics end with a thud of dead-endedness. It would be smart and better architecturally if we were to add those sections and put links under them.

netapp-dbagwell commented 1 month ago

@adamn-netapp the list topic has been removed. Relevant links were inline already in other topics or added inline where relevant. I'll create an internal issue to think about the broader use of a Related information section throughout ONTAP.