DocM

[Patrys :: Patryk Zawadzki]

Wczoraj miała miejsce dyskusja na ircu na temat wybrania DocM. Ciężko
streścić, więc puszczam pociętego loga. Czy jest ktoś chętny do zostania
DocMaintainerem dla obecnej dokumentacji (svn)? Jeśli nie, to ja się tym
chętnie zajmę. Jeśli tak, to moge nadzorować sekcję angielską, jako że i
tak sam ją piszę.

- - - - - - - - - 8< cut here >8 - - - - - - - - - -

18:19:37 * patrys jest załamany dokumentacją
18:27:18 <@agaran> patrys: jaka znowu dokumentacja?
18:27:25 <@patrys> agaran: do PLD
18:27:56 <@agaran> aham
18:28:07 <@patrys> agaran: każdy rozdział z innej parafii
18:28:16 <@patrys> i każdy po swojemu wszystko robi
18:28:56 <@patrys> w jednym rozdziale jest opisane do czego służy
modprobe.conf, a w innym koleś każe wszystko do /etc/modules ładować, a
kartę muzyczną przez google konfigurować
18:29:34 <@patrys> chyba nie po to kurwa mamy narzędzia w systemie żeby
się manual składał z jednego rozdziału z adresem na google
18:29:52 <@krzak> no ale generalnie to ma racje
18:30:12 <@patrys> generalnie to powinno być konsekwentne
18:30:20 <@patrys> poza tym mamy pldconf i alsaconf
18:30:38 <@patrys> i działają szybciej niż google dla kogoś kto PLD
widzi pierwszy raz
18:30:43 <@krzak> patrys: wtedy zaczynalo by sie i konczylo na "sprawdz
na http://www.google.com"
18:30:55 <@krzak> alsaconf obsysa
18:30:58 <@patrys> krzak: no właśnie, to ja taki manual od zaraz napiszę
18:30:58 <@krzak> wiesza sie
18:31:23 <@patrys> obsysa ale jak jej dasz ctrl+c to pójdzie dalej i
koniec końców zainstaluje karte
18:32:09 <@patrys> natomiast przeciętny dwunastoletni haxxx0r nie
poradzi sobie z zaawansowaną technologią zawartą w interfejsie googli
18:32:38 <@patrys> a nawet jak już skuma do czego to jest to nie będzie
miał pojęcia czego szukać
18:33:19 <@patrys> to tak jakby kogoś kto pierwszy raz w życiu dotyka
komputera skwitować "idź na pcol"
18:34:22 <@patrys> albo robimy dystrybucję i mówimy ludziom że to się da
prościej zrobić, albo robimy system dla developerów i nie ma sensu
manuala pisać
18:34:29 <@krzak> patrys: ale pld nie jest userfriendly
18:34:41 <@krzak> i nigdy nie bedzie, trzeba na wiele rzeczy poprostu
wpaść
18:34:52 <@patrys> krzak: ale co szkodzi o tym napisać
18:35:02 <@krzak> patrys: ja nie jestem przeciwny
18:35:09 <@patrys> dziwne jak ktoś z googli więcej się dowie o swoim
systemie niż z jego dokumentacji
18:35:13 <@krzak> ja nawet nie jestem za tym nieuserfiendly
18:35:35 <@krzak> jak bym chetnie widzial gotowe klocki ktore zawsze
zadzialają
18:35:37 <@patrys> nieuserfriendly to dobrze, bo się ludzie czegoś
nauczą, ale trzeba nimi pokierować
18:36:27 <@patrys> chyba że zatrudnimy kogoś na etat na #pldhelp
18:36:51 <@patrys> ale wtedy manual musi przynajmniej mówić, że istnieje
coś takiego jak #pldhelp i jak wejść na irca
18:37:11 <@patrys> najlepiej spod windowsa bo linuksa nikt nie postawi
sam ;]
18:37:19 <@patrys> przynajmniej nie tego
18:38:31 <@patrys> napiszę we wstępnie do en.docs że łyżeczka nie
istnieje i nie powinieneś próbować nagiąć linuksa do potrzeb swojego
umysłu tylko swój umysł do potrzeb linuksa
18:40:04 <@patrys> aż mam ochotę się sam sfortunkowac dla potomnych ale
nie będę przeginał
18:40:11 <@krzak> patrys: potrzebny jest konfigurator z instrukcją
obsługi
18:40:18 <@krzak> i ludki dadza sobie radę
18:40:29 <@krzak> a pozniej, gdzies, konkretniejsze rzeczy
18:40:29 <@patrys> krzak: no to przecież po to jest pldconf
18:40:49 <@krzak> ja doceniam to co jest robione w ramach pldconf
18:40:55 <@krzak> ale, probowales tym skonfigurowac system ?
18:41:01 <@patrys> tylko jest robione na oślep
18:41:07 <@patrys> nie, umarłem na widok screenów
18:41:07 <@krzak> najpierw musiales zainstaowac go poldkiem
18:41:13 <@krzak> czyli juz miec dzialajacy system
18:41:15 <@krzak> :)
18:41:19 <@patrys> wygląda jak koszmarny sen początkującego usera
18:42:22 <@patrys> krzak: to mam napisać w manualu "aby skonfigurować
sieć, pobierz poldkiem pldconf z naszego serwera ftp"? :D
18:42:39 <@agaran> patrys: cos w tym jest co mowisz.. ale pewnie masz
racje
18:43:19 <@patrys> imo pldconf powinien się instalować z podstawowym
systemem
18:43:33 <@djurban> ca czemu nie?
18:43:36 <@djurban> wygodny jest
18:43:39 <@patrys> bo nie powiesz człowiekowi jak skonfigurowac
vfsjuggle
18:43:43 <@djurban> chociaz ja wole tam samemu piac XF86Config
18:44:00 <@patrys> djurban: ale kowalski nie woli bo nie wie co to
18:44:11 <@patrys> auczy się jak przeanalizuje gotowy plik
18:44:15 <@patrys> a skąd go weźmie? ;]
18:44:33 <@patrys> to samo z dhcpd
18:44:41 <@patrys> przychodzi bez example
18:44:57 <@djurban> patrys, jak chcesz to z knicvrem w ramach
instalatora bedziemy robic cos ala konfigurator podstaw
18:45:02 <@djurban> patrys, do reszty zaprzegniemy webmina
18:45:02 <@patrys> nawet jak wiesz jak to działa to ciężko z pamięci
zgadnąć wszystkie polecenia jak się nazywają
18:45:09 <@djurban> pare zmian i mozna sprzedawac PLD :)
18:45:28 <@djurban> knivre juz mysli o firmie, narazie badamy rynek, czy
wogole mozna zarobic w polsce na linuksie
18:46:06 <@patrys> djurban: można, bierzesz karton płyt z pld i rzucasz
nim w faceta wychodzącego z banku z walizką
18:46:18 <@djurban> patrys, hahaha
18:47:09 <@patrys> djurban: ale jak zaczniecie zarabiać, to konfigurator
w tajemniczych okolicznościach zniknie z pld ;]
18:47:39 <@djurban> patrys, zobaczymy, narazie wiemy ze na pewno
instalator bedzie LGPL
18:47:56 <@djurban> patrys, bo inaczej Qt/E nie ma jak uzyc
18:48:29 <@djurban> w sumie mzoe warto go zamknac
18:48:32 <@djurban> hmmm
18:48:41 <@djurban> patrys, przemysle twoj pomysl
18:49:35 <@patrys> djurban: Qt w wersji embedded? licencja edukacyjna
albo gpl to oczywiste
18:50:05 <@djurban> patrys, do zarabiania musze miec licencje ktora
pozwoli zlinkowac sie z Qt/E komercyjnym
18:50:08 <@djurban> pasuje BSD
18:50:11 <@djurban> ale z ideowych nie moge
18:50:48 <+wysek> djurban: z ideowych? tzn? :)

[...]

18:51:51 <@agaran> patrys: cii i dokumentacje rób
18:52:07 <@patrys> agaran: kiedy nie mogę bo aż szkoda to tłumaczyć
18:52:23 <@patrys> wysłałem prośbę o korektę polskiej wersji na pld-doc
18:52:24 <@agaran> patrys: no to trzeba napisac guidline dla tworzocych
i zaczac ujednolicac
18:52:50 <@agaran> patrys: widzisz ludzie którzy to pisza niekoniecznie
pisac potrafia..
18:53:16 <@agaran> patrys: i owszem checi maja, wiedze merytoryczna tez
ale korekta by sie przydała wiec pracuj..
18:53:41 <@patrys> agaran: ale wiedza merytoryczna powinna być
uniwersalna a nie "ja tak zrobiłem i mi tak zadziałało"
18:54:11 <@patrys> agaran: jeśli wspieramy modprobe.conf to nie każmy
wrzucać wszystkiego do /etc/modules
18:54:20 <@agaran> patrys: hmm.. pewnie tak, chcesz to post na pld-devil
ze bedziesz cenzurowal/korygowal dokumentacje tak zeby miała jeden
zdecydowany styl, napisac guide dla piszacych i juz
18:54:23 <@krzak> patrys: ale sie nie da :)
18:54:24 <@patrys> modprobe jest bardziej elastyczne
18:54:35 <@krzak> patrys: do modules trzeba duzo wrzucic zeby to
dzialalo
18:54:49 <@patrys> krzak: ale na 100% nie moduły od alsy
18:54:59 <@agaran> patrys: super dobre zalozenie wiec zrob ten guideline
pchnij to na liste, ew CDG to obgłosuje i bedzie po problemie
18:55:21 <@patrys> agaran: a ja będę miał jeszcze więcej roboty z
docs ;]
18:55:48 <@agaran> patrys: hmm i tak i nie, bo jesli ludzie zaczna pisac
wg guidea to przestaniesz poprawiac styl w takim stopniu
18:56:06 <@krzak> nie da sie napisac dokumentacji/konfiguratora jesli
sposob konfiguracji sie co chwila zmienia
18:56:13 <@patrys> agaran: to bym musiał założyć katalog ___RTFM___ w
svn
18:56:14 <@krzak> i nie ma jasnych wytycznych
18:57:02 <@patrys> poza tym przydałoby się dodać do pldconf opcje wyboru
spośród zainstalowanych wm
18:57:21 <@patrys> żeby sobie defaulta zmienić i na system i na usera
18:57:29 <@agaran> patrys: ej.. w czym problem zeby Ci ludzie to
przeczytali.. dopuki nie przejzysz dokumentacji i nie zaaprobujesz nie
idzie do produkcji wiec w ich interesie bedzie przeczytac guideline zeby
aprobate dostac.. 
18:57:50 <@patrys> agaran: ale docs mają się automatem budować z svn
18:58:14 <@agaran> patrys: ale mozna ustawic zeby byl exclude prawda?
18:58:20 <@patrys> można
18:58:25 <@agaran> patrys: sterowany wg aprobaty i juz.. 
18:58:41 <@agaran> i nawet automat moze je ustawiac a czlowiek zdejmowac
jak zaaprobuje zmiany do tego czasu wisi stara wersja
18:58:47 <@agaran> niewiem w cvs bym to zrobil tagowaniem
18:58:53 <@agaran> svn nieznam
18:59:01 <@patrys> też możesz tagować
19:00:22 <@agaran> patrys: przeciez taki mechanizm bedzie latwo
umozliwial sprawdzenie co i jak nawet mozna autogenerowac raport które
fragmenty sa w innej wersji niz HEAD bo nie przejzane
19:02:33 <@patrys> agaran: pomijam już fakt, że o ile polska fleksja i
gramatyka są wymagane w specach, to w docs jest anarchia i świat chaosu
19:03:32 <@agaran> patrys: coz tutaj tez pomoze tagowanie.. jak jest
nieparsowalne dla jezyka polskiego to -rNONE i niema na wuwuwu tego
19:04:01 <@patrys> agaran: ale człowiek submitujący też może tag zmienić
na head
19:04:15 <@agaran> patrys: hmm w CVSie sa zrobione acle i nie kazdy moze
wszedzie zmieniac..
19:04:17 <@patrys> chyba że acl zaimplementujesz po stronie serwera
19:04:25 <@patrys> no wlasnie
19:04:25 <@agaran> patrys: nieznam svn, ale pewnie tez to potrafi
19:04:29 <@patrys> a to juz zakraw na paranoje
19:04:32 <@agaran> patrys: to _niejest_ problem
19:04:48 <@agaran> patrys: ee nie, CVSROOT jest oslaniany branche sa
osłaniane czy to paranoja? nie.. raczej bezpieczenstwo
19:05:01 <@agaran> a skoro chcemy miec przyzwoite doce, to musimy w
jakis sposob zapewnic jednolitosc tego
19:05:06 <@agaran> wiec bez tagowania itp nieda sie tego zrobic
19:05:11 <@agaran> i najwyzej generowac 2 wersje
19:05:12 <@patrys> imho trzeba doc maintainera wybrac
19:05:22 <@agaran> publicznie widoczna z approved
19:05:33 <@agaran> i HEAD zeby deviloperzy mogli obejzec stan bierzacy
19:05:35 <@agaran> ano trzeba
19:05:37 <@patrys> i wprowadzic polityke boskiej wladzy i ucisku
19:05:43 <@agaran> niee
19:05:47 <@patrys> ;]
19:05:50 <@agaran> poprostu ten mechanizm tagowania i wystarczy
19:06:10 <@agaran> z jednej strony da to mozliwosc kontroli co idzie na
docs z drugiej mozna podejzec co nie poszło
19:06:13 <@agaran> i chyba o to chodzi
19:06:16 <@patrys> no ale chodzi o to ze jakas grupa ludzi musi to
nadzorowac
19:06:23 <@agaran> ja nie mowie ze nie
19:06:25 <@patrys> zebysmy sie nie bili lopatkami w piaskownicy
19:06:30 <@agaran> propozycja glosowania do CDG i juz
19:06:38 <@agaran> pocos to CDG powstało..
19:06:57 <@agaran> ew przekleic nasza rozmowe w mail, na pld-devil
poprosic o komentazre
19:06:59 <@agaran> komentarze

[...]

19:07:50 <@agaran> jest RM
19:07:55 <@agaran> jest Doc-M
19:07:57 <@agaran> i koniec
19:08:11 <@agaran> on decyduje i ew głosowanie o zmiane DocM
19:08:19 <@agaran> jak ktos niewidzi innej metody
19:08:26 <@patrys> no chyba ze tak
19:08:58 <@agaran> nikt nie mowi ze musza byc jedne doce
19:09:12 <@agaran> moze byc DocM dla AC moze byc DocM dla whateverelse

[...]

19:10:19 <@patrys> wlasciwie to jest chyba akademicki spór, bo jak
powiem, co mi się nie podoba w docs to nikt się nie podejmie ani bycia
DocM ani pisania ;]
19:10:40 <@agaran> hmm.. ale mozesz zebrac to o czym rozmawiamy w mail i
pchnac na devil
19:10:44 <@agaran> sprawdzić nie zaszkodzi
19:10:46 <@krzak> patrys: nie gadaj, tylko zacznij robic
19:11:22 <@patrys> robie
19:11:28 <@patrys> caly czas
19:11:30 <@krzak> no i dobrze
19:11:33 <@patrys> sprawdz logi z svn
19:11:34 <@agaran> patrys: piszesz maila mam rozumiec?
19:11:35 <@patrys> ;]
19:11:43 <@patrys> nie mam jak wkleic tego z irssi

[...]

19:11:48 <@krzak> w jaki sposob cdg mialoby ci pomoc ?
19:11:58 <@patrys> krzak: wybrac DocM
19:12:06 <@krzak> patrys: DocM sam sie musi zglosic
19:12:22 <@patrys> krzak: co nie znaczy ze nim zostanie automatycznie
19:12:29 <@agaran> ale dopuki na liste ktos nie napisze ze potrzebny
jest
19:12:45 <@agaran> takowy i do czego to pewnie sam sie nie pojawi
19:13:07 <@patrys> agaran: masz to gdzieś zlogowane wszystko?
19:13:16 <@agaran> patrys: hmm chyba tylko w scrollbuforze..
19:13:25 <@patrys> bad thing
19:13:38 <@patrys> chciałem całość puścić na listę
19:13:59 <@agaran> hmm zloguje.. tylko wymysle jak.. 


-- 
Patrys :: Patryk Zawadzki <patrys w wrocek.org>
MSR crew