@minego #SoftwareDevelopment #technicalDocumentation

When you get the integration documentation from the 3rd party and everything seems fine on first glance. Upon the 2nd, however...

#APIs #softwareDocumentation #technicalDocumentation #developerHumor #programmerHumor
https://social.treehouse.systems/@hugo/110698141725636359

#AI #ML #Ethics #Law #CompSci #TechnicalDocumentation: "The growing need for accountability of the people behind AI systems can be addressed by leveraging processes in three fields of study: ethics, law, and computer science. While these fields are often considered in isolation, they rely on complementary notions in their interpretation and implementation. In this work, we detail this interdependence and motivate the necessary role of collaborative governance tools in shaping a positive evolution of AI. We first contrast notions of compliance in the ethical, legal, and technical fields; we outline both their differences and where they complement each other, with a particular focus on the roles of ethical charters, licenses, and technical documentation in these interactions. We then focus on the role of values in articulating the synergies between the fields and outline specific mechanisms of interaction between them in practice. We identify how these mechanisms have played out in several open governance fora: an open collaborative workshop, a responsible licensing initiative, and a proposed regulatory framework. By leveraging complementary notions of compliance in these three domains, we can create a more comprehensive framework for governing AI systems that jointly takes into account their technical capabilities, their impact on society, and how technical specifications can inform relevant regulations. Our analysis thus underlines the necessity of joint consideration of the ethical, legal, and technical in AI ethics frameworks to be used on a larger scale to govern AI systems and how the thinking in each of these areas can inform the others."

https://arxiv.org/abs/2305.18615

The #howto #technicaldocumentation #repository on #confluence is building nicely for #Maolte #Technical #Solutions after my latest #demo #project contributed to it just yesterday evening. More at https://maolte.ie ... #technicalwriting #cloud #devops #cloudinfrastructure #systemadministration

when writing #technicalDocumentation - don't use real #urls or #ipAddresses. you never know what will grab those and use them.

there are reserved #domains and #ipRanges for just this!

for #url: the top-level-domains
.test, .example, .invalid and .localhost and the domain example.com are reserved

for ip-adresses the blocks 192.0.2.0/24, 198.51.100.0/24 and 203.0.113.0/24 are reserved

they are always safe to use in #documentation

Let’s Make SCPI More Helpful https://hackaday.com/2023/02/02/lets-make-scpi-more-helpful/ #self-documentinginterface #Technicaldocumentation #SoftwareHacks #ToolHacks #libscpi #scpi

Let’s Make SCPI More Helpful - The SCPI (Standards Command for Programmable Instruments) protocol is exceptionall... - https://hackaday.com/2023/02/02/lets-make-scpi-more-helpful/ #self-documentinginterface #technicaldocumentation #softwarehacks #toolhacks #libscpi #scpi

Heute Abend online:

Docs Repair Cafe

https://www.meetup.com/continuous-documentation-regulars/events/290277704/

Ever wondered how to fix an annoying itch in your tech setup? This is the first edition of a "Docs Repair Cafe", where users can discuss what troubles them in their current setup. In the process, they'll get ideas and tips on how to fix it from other participants.

#AsciiDoc
#AsciiDoctor
#TechDoc
#TechnicalDocumentation
#TechnischeDokumentation