wtorek, 30 marca 2021 o 23:00:20 UTC+2 Maciej Sobczak napisał(a):

> > 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.

Podejrzewam, że "is embedded in the source code" można rozumieć różnie --
niekoniecznie jako odróżnienie.
Skrzynia biegów albo silnik też jest "embedded" w samochód, i raczej byśmy
powiedzieli, że skrzynia biegów "jest częścią" samochodu, niż czymś "odróżnionym od
samochodu"

> > 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.

Ale więc "co" "nie"?
Jest omówiona, czyli jest omówiona.
W artykule dotyczącym dokumentacji oprogramowania.
Więc tak.

> > 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.

Tzn. raczej zgadza się z "Twoim odczuwaniem Wikipedii", niż z czymkolwiek, co tam
jest napisane.

> > Mnie się zdarza studiować asembler, dokładnie w tym celu, żeby zrozumieć, co robi
system
> A co, nie było dokumentacji? :-D

Mam jeszcze raz zacytować definicję spod linku, który wkleiłeś? OK:

"any communicable material that is used to describe, explain or instruct regarding
some attributes of an object, system or procedure, such as its parts, assembly,
installation, maintenance and use"

Zobacz, "assembly" jest nawet wymienione explicite ;]

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.

"or embedded in"

"embedded in" oznacza, że jest w środku.