Dobrá zpráva, dokumentace bude! Co brání „dev“ verzi v nasazení?
- David Grudl
- Nette Core | 8227
Konečně nastane přítrž všemu remcání, že Nette Framework nemá dobrou dokumentaci! Dokumentace bude, kvalitní a psaná přímo na míru pro verzi 2.0. Bude ještě letos.
Předtím, než se pustím do psaní dokumentace a zmrazím vývoj, bych rád proměnil současnou „dev“ verzi ve „stable alpha 2“. Ta terminologie zní divně, alpha proto, že seznam vlastností ještě není uzavřen, a stable proto, že by neměla obsahovat chyby, což je stav, který se snažím udržovat průběžně.
Chtěl bych se proto zeptat, co je v současné „dev“ verzi
největší překážkou, co brání přechodu na ni.
Pokusím se vyřešit hlášené issues, zejména tento
týkající se AJAXu Vyřešeno.
(bylo by fajn, kdyby diskuse šla k věci, tj. neřešme chystané vlastnosti nebo co doplnit, ani nekonkrétní oblasti (jako třeba výkřiky AJAX, formuláře, …), ale přesně co a jak a proč fixnout nebo dodělat)
- Jan Tvrdík
- Nette guru | 2595
Night build verzi už nějakou dobu reálně nepoužívám (nemám projekt, kde bych mohl), ale jak jsem si pročítal změny v repozitáři, tak myslím, že jediná, v současné době nedořešené věc, které znemožňuje night build verzi použít, je nedořešená podpora AJAXu.
- Honza Kuchař
- Člen | 1662
Také myslím… A na velmi primitivní weby, už jde používat i ten AJAX. Jinak jsem také na nic jiného nenarazil.
- Ondřej Mirtes
- Člen | 1536
Nedořešený je hlavně Context, resp. dependency injection. Líbilo by se mi, kdyby třídy o dependency injection vůbec nevěděly a jejich podobu sestavoval konfigurovatelný container, jako to má třeba Symfony.
- David Grudl
- Nette Core | 8227
Context a AJAX je sice nedořešený, ale mě teď spíš zajímá, jestli současná podoba něčemu (oproti starší verzi) brání. Nic nového vyvíjet nechci. V případě AJAXu vím, že je-li $presenter->isAjax() TRUE, nejde vykreslit normálně šablonu, což chci vyřešit. Pokud jde o context, nejsem si nějaké překážky vědom.
- Vyki
- Člen | 388
David Grudl napsal(a):
Context a AJAX je sice nedořešený, ale mě teď spíš zajímá, jestli současná podoba něčemu (oproti starší verzi) brání. Nic nového vyvíjet nechci. V případě AJAXu vím, že je-li $presenter->isAjax() TRUE, nejde vykreslit normálně šablonu, což chci vyřešit. Pokud jde o context, nejsem si nějaké překážky vědom.
Z tohoto odstavce mi dávají smysl ty věci o kontextu, ale co ten AJAX? Nasazení brání to, že není dotažený, to asi z posledních příspěvků vyplývá. Nevím jestli se v posledních commitech něco změnilo, zdá se mi že ne, ale nejdou použít zanořené snippety (např v komponentách), proto by se asi hlavní zájem měl ubírat tímto směrem. Jinak asi nevím co tu dál řešit. Oproti předchozí vývojové větvi, je ta 2.0 úplně někde jinde a je samozřejmě lepší. V každém (díky snippetům téměř) směru se s ní pracuje lépe.
Editoval Vyki (11. 11. 2010 0:50)
- David Grudl
- Nette Core | 8227
pekelnik napsal(a):
V tomhle došlo oproti starším verzím k nějaké změně?
Vyki napsal(a):
EDIT: Že bude dokumentace letos znamená, že (alespoň) beta verze Nette 2.0 letos nebude?
Uvidíme, jak to půjde s psaním dokumentace, ale nesázel bych na to.
- Honza Marek
- Člen | 1664
Já bych byl rád, pokud máš hotový formuláře, abys je pushnul, protože se mi pak ty aplikace nebudou chtít přepisovat. Pokud hotový nejsou, tak to samozřejmě bohužel spadá pod kategorii novinka.
Dál bych chtěl navrhnout, jestli by se dokumentace nemohla psát verzovaná GITem.
Mělo by to následující výhody:
- Až budeš dokumentaci psát, budeš nad případnou dobře myšlenou pomocí mít větší kontrolu a budeš moci odmítat pull requesty.
- V GITu jdou udělat větve. To, že jsme tohle neměli, to je podle mě hlavní důvod, proč dokumentace tak zastarala. Nikdo nechtěl zanášet změny pro 0.9, protože byla stable 0.8. Nerad bych, kdyby se toto opakovalo s verzí 2.0 a 2.1 například.
- Změny budou na githubu dobře vidět.
- <vtip>Zvýšení motivace, protože co si budeme nalhávat, přijatý pull request od Davida Grudla je poměrně prestižní záležitost :-D</vtip>
A pochopitelně jednu nevýhodu:
- Do dokumentace je bez webového nástroje těžší přispět. I když to je diskutabilní, já bych s GITem problém neměl a navíc odpadá nutnost přihlášení v nějakém formuláři. Kompromisem by mohlo být zveřejnění „offline“ nástroje na editaci dokumentace, kterej bych moh vyrobit ale třeba i já…
- David Grudl
- Nette Core | 8227
Všechny podstatné issues a problémy s AJAXem by měly být vyřešené – jestli je tam ještě něco dalšího, hlaste co nejdříve.
Honza Marek napsal(a):
Já bych byl rád, pokud máš hotový formuláře, abys je pushnul.
Novinky až po dokumentaci. Někde se to říznout musí.
Dál bych chtěl navrhnout, jestli by se dokumentace nemohla psát verzovaná GITem.
Tohle bych nechal na později, až větvení bude na pořadu dne. Redakční systém v tuto chvíli umí vše potřebné a experimenty s GITem by si vyžádaly jen další a další prodlevy.
- David Grudl
- Nette Core | 8227
Zatím složitě: vytvořením instance $latte = new LatteMacros
a voláním metody nad objektem. Do 2.0 mám připravený zcela nový způsob
přidávání vlastních maker.
- arron
- Člen | 464
Pro me je zatim zasadnim problemem nemoznost nejak rozumne nahradit
Application
svym potomkem. Musel bych vytvorit nekde nejakou
funkci, ktera bude delat presne to same co ta stavajici, ktera
Application
vytvari, a tam prepsat jeden rade. Oproti predchozimu
stavu, kdy jsem tuto zmenu udelal elegantne v configu je pro me tohle
neprijatelne.
Navic cely ten Context je takovy zvlastni a byl bych vsema deseti pro jeho dotazeni do konce. V teto podobe mi to prijde cele matouci, nepouzitelne (uz jenom proto, ze jsem vlastne moc nepochopil jake ze to ma ted teda vyhody) a tim vlastne i zbytecne :-)
- David Grudl
- Nette Core | 8227
Možnost změnit třídu Application jsem doplnil, via
service.Nette-Application-Application.option.class = jinatrida
Context se bude řešit až po dokumentaci.
- jtousek
- Člen | 951
@DG: Bude během psaní dokumentace probíhat oprava drobných chybek ve frameworku? Mám tady asi 10 drobností, které se mi tu nahromadily za celou dobu co s Nette pracuju. Mohu to postnout až bude kdy nebo to mam nechat až po dokumentaci?
Dále dokumentaci chceš psát celou sám nebo uvítáš drobnou pomoc?
- David Grudl
- Nette Core | 8227
jtousek napsal(a):
@DG: Bude během psaní dokumentace probíhat oprava drobných chybek ve frameworku? Mám tady asi 10 drobností, které se mi tu nahromadily za celou dobu co s Nette pracuju. Mohu to postnout až bude kdy nebo to mam nechat až po dokumentaci?
Jasně, vytvoř vlákno a hoď to tam.
Dále dokumentaci chceš psát celou sám nebo uvítáš drobnou pomoc?
Hehehe :-)
- jtousek
- Člen | 951
David Grudl napsal(a):
Dále dokumentaci chceš psát celou sám nebo uvítáš drobnou pomoc?
Hehehe :-)
Trefné. :-) Vím, že se dokumentace měla psát kolektivně, i jsem psal vrtákovi aby mi udělal nějakej ten účet na basecamp, na což se mi nedostalo odpovědi. Ty jsi vlastně zklamán z toho, že dokumentace od komunity se nějak kloudně nehejbala tak ses rozhodl ji napsat sám. Tento krok z tvé strany chápu, ale je škoda, že komunita v tomhle zklamala. Nicméně když ses teď rozhodl tu dokumentaci napsat, není mi jasné zda ji chceš psát opravdu sám anebo se může někdo přihlásit s tím, že udělá tu a tu sekci. Pokud ano, kde se dobrovolníci mohou hlásit?
- David Grudl
- Nette Core | 8227
Situací kolem dokumentace jsem zklamán a nemám žádnou jinou možnost, než ji napsat sám. Proto jsem k dnešnímu dni zmrazil vývoj, vydal verzi „alpha2“, ostrou odsunul na neurčito a pokračovat budu až po dopsání dokumentace. To neznamená, že byste nemohli diskutovat o vývoji nebo posílat issues. Pokud někdo nějakou část zpracuje (osnovy jsou 4 měsíce nachystané), ušetří mi tím čas. Ale od nikoho nic neočekávám, nic neorganizuju, netřeba se nikam hlásit.
- Bernard Williams
- Člen | 207
David: Včera jsem si začal procházet https://doc.nette.org/ a opravoval překlepy a taky jsem jich už hezkou řádku opravil. Znamená to teď pro mě, že se na to mám vyprdnout nebo v tom mám pokračovat? A pokud mám pokračovat, tak se stále jedná o https://doc.nette.org nebo se dokumentace nachází na jiné adrese?
Bernard
- Jan Tvrdík
- Nette guru | 2595
Bernard Williams napsal(a): Znamená to teď pro mě, že se na to mám vyprdnout nebo v tom mám pokračovat?
Samozřejmě pokračuj, adresa se nemění. Díky za každý překlep, který opravíš!
- westrem
- Člen | 398
Mozno budem az prilis odvazny, ale rad by som sa opytal aky je momentalne stav?
Beriem to tak, ze sa teda pise dokumentacia a hlavny vyvoj je stale pozastaveny. Je este stale platne tvrdenie, ze by dokumentacia mohla byt tohto roku? (Predsa len su Vianoce za dverami a myslim si, ze kazdy ma narok na oddych), pripadne kedy mozme ocakavat obnovenie vyvoja Nette 2?
Dakujem, za odpoved na otazku, ktora nema posobit provokacne ale naopak, cisto informacne.
- David Grudl
- Nette Core | 8227
Do vánoc to asi nestihnu, mám hotových tak 50 %. Na druhou stranu jsem vývoj zcela neutnul. Člověka holt některé dny baví víc psát texty, jiné dny zase kód.
- tatyalien
- Člen | 239
Já se nebojím, ale rád bych si něco počet ;) zhruba před pár měsíci jsem si prošel quick start atd, ale teď kydž juknu na něj znova už nevím o co go :-( a na nette 2.0 mě vše podle návodu už nefachčí :( tak jsem se chtěl už nějak kouknout konečně na něco, podle čeho bych se rozkoukal a zkusil něco v něm napsat…
- tatyalien
- Člen | 239
Ještě se jen zeptám, bude pak v dokumentaci a s ní napojené quick
start, a ostatní tutoriály používat doporučenou verzy Nette s prefixama?
Protože co jsem koukal, tak u stažení David radí používat verzy
s prefixy, ale návody používají neprefixovanou (místo třídy NObject
používá Object apod).
Samo, pokud mě to skočí do laděnky, zkouším nejdřív dopnit zmíněné
„N“ :-D
- Patrik Votoček
- Člen | 2221
dokumentace a veškeré nově vznikající tutoriály (včetně nového QuickStartu) jsou psány pro namespace (PHP 5.3) variantu Nette. Jelikož se jedná o preferovanou verzi.
- westrem
- Člen | 398
Priznam sa, ze po 2.5 mesiaci od mojho prveho dotazu sa tak trochu bojim opytat znovu a tak trochu mi pride cudne, ze sa nikde neda docitat ani o priebeznom stave dokumentacie (kludne ked aj len v percentualnej podobe kolko je uz cca hotoveho).
Neberte to nijak ako dotieravu otazku, len podla Davidovych vyjadreni som cakal, ze tak nejak sa bude dat sledovat (ked aj pomaly) vyvoj v oboch smeroch. Github vsak cekujem denne a nejak velke zmeny nie a nie vidiet, skor len fixovanie preklepov, pripadne nejakych malych bugov.
Pytam sa preto smelo a znovu, v akom stave je momentalne dokumentacia?
Za konstruktivnu odpoved vopred za seba (a asi aj komunitu) dakujem.
- Filip Procházka
- Moderator | 4668
Jelikož všichni známe Davida, dalo se očekávat, že bude jako vždy ticho po pěšině a pak najednou booom a budeme všichni připosraní jak je to super :)
- westrem
- Člen | 398
norbe napsal(a):
Co se dokumentace týče, tak nedávno David twittnul něco o 90%.
Wut? Twitter sledujem denne a Davida followujem, ako je mozne ze mi to nezobrazilo vo feede? Tym padom beriem tak trochu spet co som napisal, ale aj tak by mozno bolo dobre mat tu oficialne potvrdene aky je stav – viac menej mi je jedno ci David prave programuje, pise dokumentaciu, opravuje nejake male bugy, sedi v hospudce a uziva si zasluzeny oddych alebo tweetuje cierne vtipy o Japonsku.
Len pristup, ze je 2.5 mesiaca ticho tichucko mi nepride koser voci komunite a ako spravny pristup propagovania Nette. Ja sam odporucam Nette kade chodim ale vzdy bohuzial musim ludom vraviet, ze si musia pockat, pretoze mmtalne je vo vyvoji 2ka, ktora nie je nieco ako pseudo stable, riadne stable 0.9.7 sa uz nevyvija a teda by bolo blbe zacat na nej stavat projekty a ze poriadna a nova dokumentacia sa prave pise takze ani nemaju prilis odkial brat zdroje o novej Nette 2. Ano, mozem ich odkazat na materialy k 0.9 vetvam, ale skor by to pre nich bola duplicitna praca studovat nieco a potom studovat zmeny, ako priamo studovat veci k 2ke. Potom je smutne, ked vecsina z nich ide k Zendu alebo CakePHP pretoze potrebuju nejaky stabilny FW teraz a nemaju cas cakat pripadne sa hrabat v nuansoch Nette 2.
--
vyssie napisane je moj osobny subjektivny nazor
- Tharos
- Člen | 1030
westrem napsal(a):
Potom je smutne, ked vecsina z nich ide k Zendu alebo CakePHP pretoze potrebuju nejaky stabilny FW teraz a nemaju cas cakat pripadne sa hrabat v nuansoch Nette 2.
Proč smutné. :) Jedná se snad o nějak řádově horší frameworky? Já vím, že Nette má kolem sebe něco jako „Apple auru“ a pro řadu lidí je až náboženstvím, ale ruku na srdce, neřekl bych, že je třeba o třídu jinde, než jiné frameworky. Má spoustu svých výhod i nevýhod.
Mně osobně mrzí, že v zahraničí současným stylem asi opravdu Nette neprorazí. Přijde mi, že Nette přišlo nezávisle na jiných frameworcích s řadou revolučních myšlenek, ale ty už jsou v nových verzích světových frameworcích též naimplementované (a nemyslím si, že by se inspirovaly u Nette, prostě některé věci jsou přirozeným výsledkem evoluce). A proto technicky mi už Nette nijak výjimečné nepřipadá. A když jde o zbytek (styl vývoje, komunitu, rozšířenost, podpora…), tak v tom oproti například Symfony či Zendu Nette IMHO totálně propadá.
Hodně teď sleduji vývoj Symfony 2.0, což je svou filosofií framework docela příbuzný, a osobně bohužel nevěřím, že by se třeba jen v jeho konkurenci mohlo Nette nějak výrazně prosadit („bohužel“ píši proto, protože bych to Nette samozřejmě přál).
- Patrik Votoček
- Člen | 2221
Tharos napsal(a):
Proč smutné. :) Jedná se snad o nějak řádově horší frameworky?
Nejedná ale jsme tady na Nette fóru takže je pro nás smutné když víme o někom kdo si nevybral to naše… (v zásadě jsi na to i sám odpověděl poslední větou ve svém postu :) )
Mně osobně mrzí, že v zahraničí současným stylem asi opravdu Nette neprorazí. A když jde o zbytek (styl vývoje, komunitu, rozšířenost, podpora…), tak v tom oproti například Symfony či Zendu Nette IMHO totálně propadá.
Věz že tohle je téma/problém který je na pořadu dne v řešení. V zásadě se dá říct že se Stable Nette 2.0 by mělo být tohle hlavním tématem/problémem tohoto roku. A mělo by se toho spousta změnit.
Hodně teď sleduji vývoj Symfony 2.0, což je svou filosofií framework docela příbuzný, a osobně bohužel nevěřím, že by se třeba jen v jeho konkurenci mohlo Nette nějak výrazně prosadit („bohužel“ píši proto, protože bych to Nette samozřejmě přál).
Symfony 2.0 sleduje hodně z nás (sám ho beru jako takovou KPZtku kdyby se s Nette něco po***)