Documentation / Introduction / Tutorial

[milo]

Is anybody writing any type of documentation? I'll (slowly) prepare some, but I appreciate any other sources.

• read.me
• Filip's blog
• David's blog
• Ondra's slides
• Filip's slides
• Nette doc

---

The introduction finished. Czech & English

[milo]

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

[radekdostal]

👍

[Vrtak-CZ]

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

[vojtech-dobes]

@milo Great work, I have added 3 comments.

[milo]

@vojtech-dobes Thanks, updated.

[vojtech-dobes]

@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?

[milo]

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

[hrach]

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

[dg]

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)

[milo]

@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.

[dg]

@milo už posílám!

[milo]

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

[milo]

GIST updated for David's comments.

[dg]

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

[milo]

@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.

[milo]

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

[dg]

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íš?

[milo]

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á.

[dg]

@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

[milo]

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