1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
#use wml::debian::ddp title="DDP - Sprawy Bieżące"
#use wml::debian::translation-check translation="1.6"
<p>Następujące sprawy wymagają niezwłocznego rozważenia, przedyskutowania, lub
pomocy ochotników.
<br>
<ul>
<li><strong>Integracja DDP i www.debian.org</strong>
<p>Jay Treacy otworzył temat standaryzacji lokalizacji plików pakietów dla
stron internetowych oraz wewnątrz DTD. Zobacz
<a href="todo">DO-ZROBIENIA</a> po więcej szczegółów.
<br>
<li><strong>Kooperacja z LDP</strong>
<p>Musimy być bardziej związani z projektem LDP, skoro nie możemy tego wykonać
sami. Niektórzy zaczęli już zestawiać dokumenty LDP.
<br>
<li><strong>Uczynienie <tt>debiandoc-sgml</tt> bezpiecznym dla różnych języków</strong>
<p>Nie jest jeszcze całkiem jasne, co powinno być zrobione, aby debiandoc-sgml
stał się przyjaznym dla platformy wielojęzykowej. Niektórzy zaczęli pracować
nad podstawowym skryptem wydobywujący strukturę SGML, który pomaga utrzymać
jednakową strukturę dokumentu niezależnie od wersji językowej. Wiemy, że
nazewnictwo plików wyjściowych wymaga zmiany, lub przetworzone dla dokumentów
serwowanych poprzez negocjację zawartości Inne problemy wymagają określenia.
<br>
<li><strong>Pakietowanie dokumentacji.</strong>
<p>Pytaniem jest, jak dokument powiązany jest z pakietami. Mając jeden pakiet
na dokument otrzymujemy następujące korzyści:
<ul>
<li>Pakiet będzie mały. Jeśli pojedyńczy dokument zostanie uaktualniony, nie
ma potrzeby ładowania na nowo wszystkich dokumentów.
<li>Sprawy się upraszczają jeżeli ta sama osoba zajmuje się zarówno pakietem
jak i dokumentem (np. autor).
<li>Łatwiej jest zgłaszać błędy w dokumentach.
</ul>
ale także następujące wady:
<ul>
<li>Niektórzy narzekają, że istnieje już za duża liczba pakietów.
</ul>
<p>Propozycja jest następująca (być może trochę przestarzała). Obecnie zakłada
się, że instrukcje powinny być umieszczane w swoich własnych pakietach,
o ile nie są bardzo krótkie. Właściwości posiadane przez BTS oraz zdolność
do bezproblemowego tworzenia nowych wersji wydają się więc przeważać
niektóre opinie o potrzebie redukcji ilości pakietów.
<p>Sugeruję następujące pakiety Debiana:
<table>
<tr>
<th>Pakiet Debiana</th>
<th>Dokumenty</th>
</tr>
<tr valign=top>
<td>debian-doc</td>
<td>Instrukcja META, Lista zgodności sprzętu,
Instrukcja instalacji, Noty wydawcy,
FAQ, Porady, Instrukcja obsługi,
Instrukcja administrowania systemem</td>
</tr>
<tr valign=top>
<td>debian-policy</td>
<td>Zasady polityki Debiana</td>
</tr>
<tr valign=top>
<td>debian-doc-dev</td>
<td>Instrukcja projektu, Leksykon dla deweloperów,
Instrukcje dla programistów, Tworzenie pakietów Debiana, HOWTO pakietów,
Przewodnik po dokumentacji, Jak zacząć z SGML</td>
</tr>
<tr valign=top>
<td>dpkg-dev</td>
<td>Leksykon dpkg, dpkg od środka</td>
</tr>
</table>
<p>Sugeruję zmianę nazwy <strong>doc-debian</strong> na<strong>debian-doc
</strong> gdyż uważam ją za znacznie lepszą.
<p><small>(przez Adama Di Carlo (?))</small>
<p>Czy potrzebne jest określenia polityki w tej sprawie?
</ul>
|
