Conversation

Notices

1. Embed this notice
   Solène :flan_hacker: (solene@bsd.network)'s status on Friday, 01-Nov-2024 05:16:02 JST Solène :flan_hacker:

   Do you think the code of an Infrastructure as Code project is self explanatory enough that is does not require extra documentation?

   • Embed this notice
     Solène :flan_hacker: (solene@bsd.network)'s status on Friday, 01-Nov-2024 05:24:27 JST Solène :flan_hacker:

     in reply to

     • sergio_101

     @sergio_101 let's say you have an IaC repository, do you think you should write some documentation next to the code, or that the code itself is enough?

   • Embed this notice
     sergio_101 (sergio_101@social.sixdegreesofohio.com)'s status on Friday, 01-Nov-2024 05:24:28 JST sergio_101

     in reply to

     @solene
     I wish understood this question deeper, as I have serious opinions about documentation. Much different than I did earlier in my career.

   • Embed this notice
     Solène :flan_hacker: (solene@bsd.network)'s status on Friday, 01-Nov-2024 05:30:05 JST Solène :flan_hacker:

     in reply to

     • phryk 🏴

     @phryk agreed

   • Embed this notice
     phryk 🏴 (phryk@mastodon.social)'s status on Friday, 01-Nov-2024 05:30:06 JST phryk 🏴

     in reply to

     @solene <strong><strong><strong>NO.</strong></strong></strong>