🚀 go-pugleaf

> > Ideą, ktorą ja wyczuwam w tym artykule, jest odróżnienie dokumentacji od dokumentowanego obiektu. Wynika to nawet bezpośrednio z podanych tam przykładów.
> Niestety, ja nie jestem w stanie tego nigdzie wyczytać, a moje moce do wyczuwania są najwidoczniej zbyt słabe

Dlatego próbuję pomóc.

> No, ale już kliknięcie dalej mamy artykuł https://en.wikipedia.org/wiki/Software_documentation,

... w którym w pierwszym zdaniu jest "that accompanies computer software", czyli znowu jest intencja rozdzielenia obiektu od jego dokumentacji, tudzież "or is embedded in the source code" jako logistyczny wybór miejsca umieszczenia, co nadal jednak odróżnia dokumentację od kodu źródłowego.

> w którym jest m.in. omówiona koncepcja programowania piśmiennego Knutha.

Wiadomo, że "Knuth wielkim poetą był", ale po pierwsze nadal ta koncepcja odróżnia obiekt od jego dokumentacji, a po drugie ta koncepcja nie przyjęła się w sensownej skali pomimo prawie 4 dekad od ogłoszenia (1984). Więc nie.

> OK, to zamiast mówić "wykonywalny diagram nie jest dokumentacją", a później uzasadniać to linkiem do Wikipedii, z którego to nie wynika, możesz powiedzieć "ja wykonywalnego diagramu nie uważam za dokumentację, ponieważ ..."

Tak. Ponieważ nie tylko tak uważam, ale nawet przypadkiem zgadza się to z Wikipedią, którą wolę wtedy pokazać jako bardziej neutralne źródło.

> Mnie się zdarza studiować asembler, dokładnie w tym celu, żeby zrozumieć, co robi system

A co, nie było dokumentacji? :-D
To się wtedy nazywa reverse-engineering. Ale to nie znaczy, że asembler jest dokumentacją. To znaczy tylko tyle, że nie było dokumentacji.

> Jedyna kwestia jest taka, że nie każdy artefakt w tym procesie jest zoptymalizowany do rozumienia działania systemu na poziomie użytkowym.

Hm... Bo nie jest dokumentacją?

> > Więc subtelne rozróżnienie jest właśnie w tym, czy coś jest na ścieżce automatycznej generacji ostatecznego produktu. Jeśli jest, to nie jest to dukumentacja, bo ta jest z definicji obok tej ścieżki.
> Nic takiego nie znalazłem na Wikipedii.

Sam podałeś link. Tam, gdzie w pierwszym zdaniu jest "that accompanies computer software".
"Accompanies" oznacza, że jest obok.

> Proszę, tu piosenka dla Ciebie

To miłe, ale nie szukam tu muzyki.

-- 
Maciej Sobczak * http://www.inspirel.com