🚀 go-pugleaf

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.