chat.freenode.net #tryton.de log beginning Thu Feb 10 00:00:02 CET 2011 | ||
2011-02-10 02:22 -!- FWiesing(~franz@mail.tryton.at) has left #tryton.de | ||
2011-02-10 05:18 -!- yangoon(~mathiasb@p549F6BDB.dip.t-dialin.net) has joined #tryton.de | ||
2011-02-10 08:51 -!- hwinkel(~hwinkel@p5796BD26.dip.t-dialin.net) has joined #tryton.de | ||
2011-02-10 09:48 -!- paepke(~paepke@p4FEB2AA0.dip0.t-ipconnect.de) has joined #tryton.de | ||
2011-02-10 10:17 -!- udono(~udono@ip-178-200-46-169.unitymediagroup.de) has joined #tryton.de | ||
2011-02-10 13:57 -!- paepke(~paepke@p4FEB00ED.dip0.t-ipconnect.de) has joined #tryton.de | ||
2011-02-10 15:33 <udono> paepke: hi, was muss ich tun, um deine Übersetzung der clientdoku in deutsch zu bekommen? | ||
2011-02-10 16:24 <paepke> hi udono | ||
2011-02-10 16:24 <udono> paepke: hi | ||
2011-02-10 16:25 <paepke> blöderweise musst du noch ein /de_DE/ dazuhängen: http://doc.tryton.org/1.8/tryton/doc/de_DE/ | ||
2011-02-10 16:25 <paepke> nirgends verlinkt | ||
2011-02-10 16:26 <paepke> cedric meinte man sollte das build-script patchen um das automatisch zu verlinken. | ||
2011-02-10 16:27 <udono> paepke: ja, soweit war ich schon. Allerdings stimmen die ganzen links dann wieder nicht | ||
2011-02-10 16:28 <udono> paepke: oben bei den Brotkrumen... | ||
2011-02-10 16:29 <udono> paepke: vielleicht kann sphinx das auch noch nicht richtig?! | ||
2011-02-10 16:29 <paepke> ich bin unzufrieden mit der lösung der deutschen doku auf thinstation.org | ||
2011-02-10 16:29 <paepke> sphinx muss man ein paar sachen beibringen, damit es das richtig macht. | ||
2011-02-10 16:30 <yangoon> btw möchte ich mal einstreuen; was machen wir mit https://bugs.tryton.org/roundup/issue1304? | ||
2011-02-10 16:30 <paepke> diese doku auf docs.tryton.org ist afaik so erstellt das einfach _ein_ befehl abgesetzt wurde um die doku zu erzeugen. | ||
2011-02-10 16:31 <paepke> alternativ könnte man auch in docs/de_DE/ wechseln und hier ein extra built machen. dann hast du alles perfekt. | ||
2011-02-10 16:33 <yangoon> das ist übrigens mitunter der https://bugs.tryton.org/roundup/issue1567 | ||
2011-02-10 16:34 <paepke> yangoon, ja. das stimm. das ist der fehler. patches welcome. | ||
2011-02-10 16:35 <paepke> für mich stellt sich die allgemeine frage nach einer übersetzung bzw der sinnhaftigkeit der bisherigen doku für enduser und der deutschen übersetzung für Diese. | ||
2011-02-10 16:38 <udono> paepke: userseitige Doku würde ich schon perspektivisch gerne übersetzt haben. Devel doku sollte immer nur auf englisch vorhanden sein. | ||
2011-02-10 16:39 <yangoon> paepke: bin und war ich ja immer absolut deiner meinung: developer doku braucht m.E. nicht zu übersetzt zu werden, enduser doku wäre aber schön | ||
2011-02-10 16:40 <yangoon> enduser doku ist für mich bisher einzig das client manual | ||
2011-02-10 16:40 <udono> yangoon: ja, zumindest geht es in die Richtung. Die bisherige Moduldoku finde ich auch nicht gelungen. | ||
2011-02-10 16:41 <yangoon> udono: genau, die moduldoku ist ein mix aus beidem | ||
2011-02-10 16:42 <udono> yangoon: andererseits ist es schwierig. Bei der devel doku machen wir es im Prinzip 1:1 wie bei der Pythondoku. Aber bei der Userdoku fehlen ein wenig die Ideen. | ||
2011-02-10 16:42 <paepke> yangoon, gretchenfrage: wie ist denn das bei openerp gelöst? | ||
2011-02-10 16:42 <yangoon> ich frage mich ja schon seit geraumer zeit, ob eine separate deutsche doku nicht sinn machen würde | ||
2011-02-10 16:42 <yangoon> asu folgenden gründen: | ||
2011-02-10 16:42 <yangoon> 1) sehr viel freiere und bessere textformulierung möglich | ||
2011-02-10 16:43 <paepke> yangoon, mit der seperaten deutschen doku kommen wir aber wieder zur frage: wie wird man nicht speziell genug und geht doch auf die deutschen gegenbenheiten ein. | ||
2011-02-10 16:43 <udono> yangoon: Userdoku als referenz finde ich eigentlich auch zwecklus. Denn alles was man bei einem Feldnamen erklären kann, sollte sowieso in den help text. | ||
2011-02-10 16:43 <paepke> yangoon, aus dem grund hab ich im moment die idee ein buch in irgend einer form zu schreiben erstmal an den nagel gehangen. | ||
2011-02-10 16:43 <yangoon> 2) ungebundenheit vom autor des moduls, der eine änderung in der englische version akzeptieren kann, aber nicht muss | ||
2011-02-10 16:45 <udono> yangoon: wie stellst du dir die plazierung und distribution der doku vor? | ||
2011-02-10 16:45 <yangoon> von daher wäre ich für meinen teil schon glücklich, wir hätten einfach eine vernünftige deutsche gebrauchsanweisung für den client | ||
2011-02-10 16:46 <yangoon> udono: platzierung auf origo, distribution keine bzw. wer will, aknn sich ja diese holen | ||
2011-02-10 16:51 <paepke> yangoon, was sind speziell deine punkte, die dich stören? | ||
2011-02-10 16:52 <yangoon> paepke: wie meinst du? im prinzip die zwei o.g. | ||
2011-02-10 16:53 <udono> yangoon: ja, origo ist nett für tutorials. | ||
2011-02-10 16:53 <yangoon> um eine vernünftige deutsche übersetzung zu bekommen, muss ja mal die englische grundlage stimmen | ||
2011-02-10 16:54 <udono> yangoon: ja, das stimmt. | ||
2011-02-10 16:54 <yangoon> wenn ich andere anwender-handbücher anschaue, dann sind die meist mit screeshots bestückt | ||
2011-02-10 16:54 <paepke> yangoon, ich glaub nicht das für ein konsistentes Handbuch origo der richtige platz ist. | ||
2011-02-10 16:54 <udono> yangoon: wenn ich mir http://hg.tryton.org/modules/account/file/3d6f0b24f28b/doc/index.rst anschaue, dann sehe ich folgende Möglichkeiten: | ||
2011-02-10 16:55 <paepke> yangoon, die frage ist halt ob man die englische doku aufpimpt und dann übersetzt oder auf das englische verzichtet | ||
2011-02-10 16:55 <yangoon> oftmals sind die screenshots nachbearbeitet, das ist schon mal etwas, was mit englischer ursprungsdoku und deuitscher übersetzung sehr schwer zu realsieren ist | ||
2011-02-10 16:55 <udono> 1. Alle Feldbeschreibungen sollten automatisch aus den help texten des Models im Modul generiert werden. | ||
2011-02-10 16:56 <udono> 1.1 Dann hätten wir die Übersetzung gleich miterledigt... | ||
2011-02-10 16:56 <yangoon> udono: ad 1) du weißt, wie feigebig B2CK in ihren Modulen mit help texten sind... | ||
2011-02-10 16:56 <paepke> yangoon, im sphinx hast du ne möglichkeit alternative bilder über variablen anzusteuern. zb. fürs login ein en_login.jpg bzw de_login.jpg automatisch einbinden zu lassen | ||
2011-02-10 16:57 <udono> 2. screenshots können mit http://codereview.appspot.com/3804044/ automatisch angefertigt werden. | ||
2011-02-10 16:57 <udono> /können/könnten/ | ||
2011-02-10 16:57 <paepke> udono, stimmt. die uri's sind ne feine sache. | ||
2011-02-10 16:58 <paepke> udono, ich nutz da ein projekt mit dem ich screenshots von webseiten automatisch erstelle. das könnte man eventuell pimpen um auch den tryton client anzusteuern | ||
2011-02-10 16:59 <yangoon> paepke: wenn man das ans laufen bringt, wäre das natürlich eine möglichkeit | ||
2011-02-10 17:00 <yangoon> ich sehe halt immer den aufwand, den es uns verursacht, zuerst die englische doku pflegen zu müssen, bevor wir an die deutsche denken können | ||
2011-02-10 17:00 <paepke> yangoon, ja, da geb ich dir recht | ||
2011-02-10 17:01 <yangoon> und wenn mans distributorisch gerne upstream drin hätte, reicht ja ein klitzekleines veto, um evtl. lange bemühungen ad acta legen zu dürfen | ||
2011-02-10 17:02 <yangoon> von daher denke ich in bezug enduser doku eben eher separat von upstream | ||
2011-02-10 17:02 <paepke> yangoon, eine art tryton documentation project. | ||
2011-02-10 17:03 <yangoon> paepke: wenn nicht auf origo, wo würdest du es denn gerne hinlegen? | ||
2011-02-10 17:04 <paepke> yangoon, mir fällt spontan nichts ein was ein entsprechendes framework bietet. prinzipiell auf einen eigenen bereich, der sich speziell um die dokumentation dreht. | ||
2011-02-10 17:05 <paepke> ob das jetzt ein eigenes origo-projekt ist oder ob es ein wiki auf einer eigenen domain oder ein cms ist. | ||
2011-02-10 17:05 <paepke> aber das technische dahinter ist finde ich nicht die primäre frage. | ||
2011-02-10 17:05 <paepke> also technisch im sinne von "wo" | ||
2011-02-10 17:06 <paepke> theoretisch kanns auch ein mercurial repo sein wieder in rst geschrieben und per sphinx irgendwo hin exportiert. | ||
2011-02-10 17:06 <paepke> die frage ist eher wie man kollaborativ dran arbeitet bzw welche eckpunkte hier abgebildet werden. | ||
2011-02-10 17:07 <udono> ich würde doku am liebsten immer mit sphinx machen. | ||
2011-02-10 17:08 <udono> paepke: screenshot hab ich bereits rudimentär implementiert. | ||
2011-02-10 17:08 <paepke> udono, nice | ||
2011-02-10 17:18 <udono> Bei Interesse, ich hab den patch mal ausgegraben: http://codereview.appspot.com/4160044 | ||
2011-02-10 17:19 <udono> yangoon: doku mit sphinx können wir im Prinzip auch überall hosten. | ||
2011-02-10 17:20 <paepke> udono, schick. ein knöpfel im tryton. | ||
2011-02-10 17:21 <udono> paepke: ist nur ein proof of concept. Aber unter Linux gehts unter Windows könnte es gehen und macos: keine Ahnung. | ||
2011-02-10 17:21 <paepke> udono, ich vermisse am sphinx ein wenig das kollaborative. wobei man die webseite, die durch sphinx entsteht durch javascript ein wenig aufbohren könnte (direkt fragen zu einem absatz einer dokumentation stellen, bewertungen usw) | ||
2011-02-10 17:21 <udono> paepke: Ich mag ungpflegte wikis nicht | ||
2011-02-10 17:22 <paepke> udono, sphinx ist finde ich leider so uni-direktional. | ||
2011-02-10 17:22 <paepke> udono, ich mag wiki's auch nicht in dem fall. | ||
2011-02-10 17:22 <paepke> wiki's neigen leicht zur konzeptlosigkeit | ||
2011-02-10 17:30 -!- elbenfreund(~elbenfreu@p54B96E73.dip.t-dialin.net) has joined #tryton.de | ||
2011-02-10 17:31 <udono> paepke: das kollaborative lässt sich z.B. auch mit Mercurial lösen. | ||
2011-02-10 17:33 <udono> Ich mag an Sphinx, das es einem viele Schritte abnimmt, quasi immer ordentlichen Output produziert und das sich viele Sachen automatisieren lassen. | ||
2011-02-10 17:34 <paepke> udono, ja, für programmierer ist finde ich mercurial ein sehr guter weg. aber für normale benutzer ist das schwierig. | ||
2011-02-10 17:35 <udono> paepke: welcher normale Benutzer schreibt Doku? | ||
2011-02-10 17:35 <yangoon> ich denke auch, dass sphinx in verbindung mit einem repos mometnan eine gute lösung sein kann | ||
2011-02-10 17:35 <yangoon> erst mal denke ich, brauchen wir einen anforderungskatalog | ||
2011-02-10 17:36 <udono> Quelleversand Hamburg | ||
2011-02-10 17:36 <udono> ;-) | ||
2011-02-10 17:36 <yangoon> der heißt für mich: gut lesbare, optisch attraktive Anwenderdoku, nach Tryton-Versionen getrennt | ||
2011-02-10 17:37 <yangoon> dann können wir schauen, welche werkzeuge wir dafür verwenden wollen | ||
2011-02-10 17:38 <yangoon> der nächste punkt ist dann, ob das irgendwo upstream untergebracht werden kann oder ob man das selbst irgendwo verfügbar macht | ||
2011-02-10 17:38 <paepke> udono, ich glaub das es sicher ein paar leute gibt die sich gerne an sowas beteiligen möchten, aber durch eine hürde wie mercurial abgeschreckt werden. | ||
2011-02-10 17:38 <udono> yangoon: für mich kommt noch hinzu maintainability=Wartbarkeit. | ||
2011-02-10 17:38 <udono> paepke: wer denn? | ||
2011-02-10 17:39 <paepke> yangoon, für mich noch leichte übersetzbarkeit, falls upstream bei der deutschen doku abschreiben will | ||
2011-02-10 17:40 <yangoon> paepke: :D | ||
2011-02-10 17:41 <udono> yangoon: paepke: ich würde die Englische doku gleich miterledigen... | ||
2011-02-10 17:41 <paepke> udono, yangoon na dann ist übersetzbarkeit umso wichtiger | ||
2011-02-10 17:42 <yangoon> udono: das legt uns jedes mal riesige hürden auf, aber wenns denn sein soll | ||
2011-02-10 17:44 <paepke> udono, tja wer denn noch doku schreiben soll? keine ahnung. erfahrungsgemäss schreckt man aber trotzdem zurück wenn man da tools sieht, die man nicht überblickt (mercurial) | ||
2011-02-10 17:45 <paepke> ich bin für was web-basiertes, welches rst generiert für sphinx bzw man in rst eintippen kann. | ||
2011-02-10 17:45 <yangoon> paepke: ich she das eher so, dass es sowieso einer unter seine fittiche nehmen muss | ||
2011-02-10 17:45 <paepke> *duck* | ||
2011-02-10 17:45 <yangoon> wenn da ein jeder mitpfuscht, ist das nicht aus einem guss | ||
2011-02-10 17:46 <yangoon> wenn derjenige mithilfe will bzw. feedback, kann ers auf codereview einstellen | ||
2011-02-10 17:46 <yangoon> bei codereview mitzuwirken sollte einem dokuschreiber möglich sein | ||
2011-02-10 17:47 <yangoon> wer kann, könnte auch patsches direkt beisteuern | ||
2011-02-10 17:47 <yangoon> patsch patsch | ||
2011-02-10 17:49 <paepke> yangoon, udono denkt doch mal an jemanden der tryton aus nem repo installiert, keine programierkenntnisse hat aber trotzdem mithelfen will. | ||
2011-02-10 17:50 <udono> paepke: ich glaube nicht daran. | ||
2011-02-10 17:50 <paepke> wenn ich jemand nicht it-affinen aus meinem umfeld codereview oder mercurial erklären müsste... | ||
2011-02-10 17:50 <paepke> udono, du kannst natürlich recht haben. | ||
2011-02-10 17:50 <yangoon> udono: paepke http://tryton.origo.ethz.ch/wiki/blueprint_dokumentation | ||
2011-02-10 17:51 <yangoon> haut rein | ||
2011-02-10 17:51 <paepke> yangoon, super! | ||
2011-02-10 17:54 <yangoon> paepke: es kann ja jeder die doku lesen, wenn dann jemand vorschläge hat, kann man ihm das teil auf codereview stellen | ||
2011-02-10 17:55 <yangoon> paepke: ansonsten wird nach meiner erfahrung sehr oft behauptet, dass man an der doku mitwirken will, nachher passiert aber nichts | ||
2011-02-10 17:55 <yangoon> von daher bin ich da sehr der meinung von udono | ||
2011-02-10 17:56 <paepke> ok. wie ihr meint | ||
2011-02-10 17:56 <dba> .oO(fun fact: ein arbeitskollege hier ist vom kosovo, urspruenglich, und hat neulich als ich mein tryton shirt getragen habe, gesagt, dass tryton (ausgesprochen triton) 'erleuchtet' heisst in albanisch.) | ||
2011-02-10 17:57 <yangoon> dba: :) | ||
2011-02-10 18:13 <paepke> dba, sehr geil. | ||
2011-02-10 18:13 -!- reichlich(~reichlich@p5793D455.dip.t-dialin.net) has joined #tryton.de | ||
2011-02-10 18:28 <udono> dba: wunderbar. | ||
2011-02-10 18:29 <udono> dba: hat dein Arbeitskollege Lust eine albanische Community zu starten? Ist der vom 2. Nebenfach ;-) | ||
2011-02-10 18:31 <dba> udono: eher ned.. er ist web ui designer :) | ||
2011-02-10 18:32 <udono> :-) | ||
2011-02-10 18:58 -!- elbenfreund(~elbenfreu@p54B96E73.dip.t-dialin.net) has left #tryton.de | ||
2011-02-10 20:08 -!- FWiesing(~franz@mail.tryton.at) has joined #tryton.de | ||
2011-02-10 23:10 -!- johbo(~joh@statdsl-085-016-072-173.ewe-ip-backbone.de) has joined #tryton.de |
Generated by irclog2html.py 2.17.3 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!