What nobody tells you about documentation

software
documentație
(Cornel) #1

https://www.divio.com/blog/documentation/

7 Likes
(Stanciu Bogdan Mircea) #2

Imi place cum se printează această pagină. Titlu si imaginea din header devin copertă pentru print. E de apreciat când cineva folosește @media print.

1 Like
(Mihai Nica) #3

Și pentru că o imagine spune mai mult decât o mie de cuvinte:


E un punct de vedere bun despre cum ar trebui sa transmitem din conștințele noastre mai departe colegilor, prietenilor sau comunității în general
Din punctul meu de vedere, termenul de documentație are o accepțiune destul de negativă în rândul progamatorilor (e chestia aia pe care nimeni nu vrea o sa facă sau o lasă pentru ultima clipă) pentru că toata lumea se gândește doar la ceea ce e descris in articol ca reference. Problema e ceva mai vastă, pentru că până la urma tu trebuie (sau ar fi bine) să transferi mai departe și echipei/colectivității din experiența ta.

@mirceaciu treaba cu coperta e mișto, treaba cu notificarea de cookie-uri care apare în toate paginile la print nu prea e.

1 Like
([object Object]) #4

I’m stealing the picture and printing it on A3 :slight_smile:

1 Like