Documentation / Introduction / Tutorial about tester HOT 20 CLOSED

I created Introduction to Tester. It is in czech for now. When will be available in english, I'll post a link.

Vytvořil jsem úvod do používání Testeru. Zatím uložený jako GIST. Protože se mi lépe vyjadřuje v češtině, napsal jsem ho česky. Až projde review, přeložím ho do angličtiny. Jestli se zachová i česky je mi jedno.

Dobrovolníky prosím o review formou PR do GISTu (jestli to jde) anebo prostě komentářem. Návod je celkem dlouhý, ale za 20 minut se dá přečíst. Můžeme zvážit rozsekání na dílčí části/kapitoly.

Pokud bude návod přijat, potřebuji:

• někde vygenerovanou Tester API, aby do ní mohl návod odkazovat
• místo, kam návod nahrát
• rozhodnout, jestli přidáme linky na externí zdroje, např. ty uvedené v popisu tohoto PR

from tester.

👍

from tester.

co takhle http://tester.nette.org (resp.: http://api.tester.nette.org) ?

from tester.

@milo Great work, I have added 3 comments.

from tester.

@vojtech-dobes Thanks, updated.

from tester.

@milo Great, have you also added info how to read the content of section in INI dataprovider? I think (after looking at Nette\Database tests) there is no pretty API for that, right?

from tester.

@vojtech-dobes Now I undestand. An example with parse_ini_file(). I'll add it. There is no helper for it yet.

from tester.

You did id in cs? No please. En default!

from tester.

Great work! I'll send comments to the gist.

How to deal with domains is question. This http://api.tester.nette.org looks like http://auto.aktualne.centrum.cz and is really ugly.

Current schema service.nette.org/lang/[version] is not suitable for others projects. I think there are three solutions:

• service.nette.org/project/lang/[version] (api.nette.org/tester, forum.nette.org/tester) in this case we should add subfolder for framework and move current content
• project.nette.org/service/lang (nette.org/api, nette.org/forum, tester.nette.org/forum) - again, we should redirect current subdomains
• new domain with same scheme api.ntester.com, forum.ntester.com - in this case we should add brand header (like this http://www.lupa.cz)

from tester.

@dg Did you send comments already or will you? I can't find any. I would like to translate it till next week ends.

BTW: I'll never post GIST for review. It is hard to comment.

from tester.

@milo už posílám!

from tester.

@dg Thanks for review, I agree with comments. I'll update it and translate it.

from tester.

GIST updated for David's comments.

from tester.

API pro tester už běží na http://tester.nette.org/api/1.0. @milo, nechtěl bys někam vystavit i tu českou verzi?

from tester.

@dg Paráda. Zítra mi kamarád udělá korekturu angličtiny tak můžeme vystavit CZ i EN, je to překlad 1:1.

from tester.

@dg do GIST jsem přidal druhý soubor s anglickým překladem. Z mého pohledu hotovo. Kam to nahrajem?

from tester.

Great! 👍

Buď bych to použil přímo jako dokumentaci na http://tester.nette.org (kde je vlastně teď readme.md), nebo na blog. Co myslíš?

from tester.

Jsem pro vystavit to jako CZ a EN dokumentaci. Na blogu to časem zapadne. Vystavil bys to, prosím? Možná i s editací perexu, pokud se Ti pro tento účel nepozdává.

from tester.

@milo je to tam, díky moc! Hele a co třeba dát na blog alespoň upoutávku? Třeba prvních pár odstavů a pak odkaz celou stránku? http://blog.nette.org/admin

from tester.

@dg Souhlasím, něco napíšu.

from tester.