PHP fórum : :

V čem píšete projektové dokumentace ? (Různé)

paranoiq — Sun, 13 Sep 2009 22:30:07 +0200

@koubas: přesně tak jsem to myslel

@crempa: i když moje poznámka byla trošku sarkastická, myslel jsem to vážně a i já mluvím o komerčním projektu:

pro uživatele je nejlepší, když je manuál vždy po ruce – a tedy nejlépe přímo v aplikaci
zkušený uživatel má možnost doplnit dokumentaci tam, kde vývojář byl přespříliš stručný, aniž by musel podstoupit kolečko začínající hlášením chyby (a končící tím, že každý uživatel má jinou verzi dokumentace)
wiki přístup usnadňuje i psaní dokumentace. mohou ji upravovat vývojáři a testeři během práce. přímo když zjistí, že je to třeba

Kazdopadne nemuzu chtit po zakaznikoj aby zastavil cinnost a nechal psat zamestnance pulku pracovni doby po dobu jednoho tydne wikinu

to samozřejmě ne. nebo ano? ;-)

V čem píšete projektové dokumentace ? (Různé)

crempa — Mon, 07 Sep 2009 09:10:08 +0200

Potrebuju zdokumentovat projekt pro zakaznika a proto tomu rikam projektova dokumentace, vyrazy jako navod ci manual jsou asi presnejsi. Uzivatele budou BFU a tudiz to musi byt plne ilustraci a peknouckych ovalnych ukazatelu se stinem…

TRAC jako takovy povazuju za vrcholnou ukazku nepouzitelnosti a osklivosti, ale to je muj osobni nazor. Kazdopadne nemuzu chtit po zakaznikoj aby zastavil cinnost a nechal psat zamestnance pulku pracovni doby po dobu jednoho tydne wikinu… ;) Bavim se tu celou dobu o komercnim projektu a ne OSS aplikaci, tam by se urcite nejaka wiki nasadit dala…

Zkusim se podivat co v tom smeru nabizi MS Project.

V čem píšete projektové dokumentace ? (Různé)

Koubas — Mon, 07 Sep 2009 00:25:20 +0200

To co popisuješ není projektová dokumentace a o žádném podobném nástoriji nevím, ale pro opravdovou projektovou dokumentaci doporučuju Trac. Je to mix wiki a ticket systému (např. pro bug tracking a úkolování) a obě tyto funkce umí výborně kombinovat se svým browserem repozitářu SVN a podobných systémů, kde je pak možno psát wiki stránky k jednotlivým zdrojovým souborům, s (jedním z mnoha) diskusních pluginů mít např. pod každým souborem diskusi a pod., pluginů jsou mraky.

paranoiq napsal(a):

a ideální je, kldyž si uživatelé v té wiki napíšou dokumentaci sami :]

jj, už jsem viděl pár OS aplikací (třeba Magento), kde je např. v rohu odkaz „Help“, který vede na automaticky vygenerovanou URL do wiki (url se generuje např. z aktuálního modulu/controlleru, ve kterém se v aplikaci nacházíte, třeba pro panel settings v administraci wiki.example.com/refference-guide/admin/settings). Ta stránka třeba vůbec neexistuje, ale jelikož je to wiki, tak stačí, aby někdo hodný kliknul na Create page a může dokumentovat pro ostatní.

V čem píšete projektové dokumentace ? (Různé)

paranoiq — Sat, 05 Sep 2009 15:24:56 +0200

a ideální je, kldyž si uživatelé v té wiki napíšou dokumentaci sami :]

V čem píšete projektové dokumentace ? (Různé)

filda — Sat, 05 Sep 2009 09:32:26 +0200

Já jsem v tomhle trochu zvrácenej, protože si myslím, že i dokumentace pro uživatele lze psát ve wiki. Spousta wiki systémů má například export do PDF. Takže mě by stačilo najít plugin na editaci obrázků. Navíc se mi líbí ta možnost, že na wiki dokumentaci lze odkázat přímo z aplikace.

V čem píšete projektové dokumentace ? (Různé)

crempa — Sat, 05 Sep 2009 06:31:07 +0200

Nazev projektova dokumentace je mozna trochu zavadejici, mam na mysli dokumentaci pro koncove uzivatele… tj. treba onim popisem GUI jsem myslel screenshot s zlutejma bublinama, ktere to gui popisuji, ruzne ohranicene oblasti s napisy typu „sem napiste rozmery A“ atd. ⇒ to cele editovatelne i v budoucnu s prichodem novych verzi aplikace a vhodnym zpusobem kombinovane s textovou casti dokumentace…

V čem píšete projektové dokumentace ? (Různé)

filda — Fri, 04 Sep 2009 22:46:28 +0200

vložim obrázek a popíšu co na něm je, ale možná mám zcestnou představu o tom co je „projektová dokumentace“

V čem píšete projektové dokumentace ? (Různé)

crempa — Fri, 04 Sep 2009 21:18:38 +0200

wiki je az vysledek, ja potrebuju nastroj, jak ve wikine zdokumentuju screenshot z GUI ?

V čem píšete projektové dokumentace ? (Různé)

filda — Fri, 04 Sep 2009 21:05:54 +0200

obyčejná wiki s napojením na svn by nestačila?

V čem píšete projektové dokumentace ? (Různé)

crempa — Fri, 04 Sep 2009 20:09:04 +0200

Ahoj, poradíte nějaký nástroj pro tvorbu projektových dokumentací? Doteď jsem si vystačil s openoffice + paint.net ale je to takové nešikovné a těžko se s tím dokumentace udržuje aktuální a stejnorodá.

Představuju si nástroj který bude řešit vše od snímání obrazovek, přes jednoduché nástroje pro popis GUI na snímcích, následné zasazení do textu až třeba po nějaký systém verzování atd. Výstup nejlépe do PDF asi, ale kdyby to umělo na základě podkladů vytvořit i jakousi wikinu či obecně webovou dokumentaci s možností diskutovat nad jednotlivými kapitolami apod. tím lépe. O možnostech napojení dokumentace na samotný zdroják projektu a např. využívání dokumentačních komentářů si už iluze moc nedělám :-)

Jinak hledám program pro Windows a při tom co jsem si navymýšlel nepočítám s tím že bude zdarma… :-)

Díky

Redistribuce javaskriptové knihovny (Různé)

pmg — Thu, 05 Mar 2009 18:29:18 +0100

Výborně, jdu stopit copyrighty. :-)

Redistribuce javaskriptové knihovny (Různé)

David Grudl — Thu, 05 Mar 2009 17:25:06 +0100

Není.

Redistribuce javaskriptové knihovny (Různé)

pmg — Thu, 05 Mar 2009 15:53:38 +0100

Je použití javaskriptové knihovny na stránce její redistribucí? Na jednu stranu knihovnu jen používám, ale na druhou stranu si ji ode mě stáhne uživatel, tudíš ji šířím.

nějak blbnou hypertextové odkazy (Různé)

LM — Thu, 29 Jan 2009 17:16:42 +0100

Ty odkazy jsem zapsal špatně já, zajímavý že Google Chrome ty " na začátku a na konci ignoruje.

nějak blbnou hypertextové odkazy (Různé)

Tomik — Thu, 29 Jan 2009 16:17:47 +0100

Odkazy jsou v pořádku, jen musíš použít správnou Texy syntax, takže nikoli

`spl_object_hash`:"http://php.net/spl_object_hash"

ale takto:

"spl_object_hash":[http://php.net/spl_object_hash], popř. "spl_object_hash":http://php.net/spl_object_hash

nějak blbnou hypertextové odkazy (Různé)

péhápéčko — Thu, 29 Jan 2009 11:41:33 +0100

Zdravím, nějak se mi zdá, že špatně fungují hypertextové odkazy:

spl_object_hash

SplObjectStorage

Petice za zrušení softwarových patentů (Různé)

pmg — Fri, 23 Jan 2009 20:43:11 +0100

Jako vývojáři webových aplikací bychom nejspíš neměli přehlédnout tuto petici. Zvlášť zajímavý je pravý sloupec s příklady platných patentů.

Díky za spolupráci.

kategorie ORACLE (Různé)

simon — Tue, 20 Jan 2009 18:33:44 +0100

zdravim chybí mi tu sekce zamerena na databazi Oracle. predem diky

Zápis kódu v tomto fóru (Různé)

SniperCZE — Tue, 13 Jan 2009 15:29:32 +0100

David Grudl napsal(a): …ale v praxi na diskusních fórech se to nepoužívá.

V tom pripade budma radi za barevnej kod :) ok, budu si muset zvyknout pastovat kod s enterama

Zápis kódu v tomto fóru (Různé)

Tomik — Sun, 11 Jan 2009 21:59:03 +0100

Nechme Davida dýchat. A buďme rádi, že máme vůbec nějaký kód barevný!

Zápis kódu v tomto fóru (Různé)

David Grudl — Sun, 11 Jan 2009 21:35:01 +0100

SniperCZE napsal(a):

David Grudl napsal(a):

Šlo, ale v praxi se to nepoužívá.

No nevim, ja to pouzivam docela casto. V sablonach zend_view je to docela uzitecny.

…ale v praxi na diskusních fórech se to nepoužívá.

K tomuto fóru (Různé)

Tomik — Sun, 11 Jan 2009 21:13:46 +0100

David Grudl napsal(a):

Nepřehánějte :-) Nahrát pár skriptů na web nestojí za řeč. Děkujte lidem, kteří se o chod fóra budou starat, kteří budou předávat své knowhow a dělit se o rady.

V tom případě díky Davide, že se o to tady staráš a předáváš nám svoje knowhow. :)

Zápis kódu v tomto fóru (Různé)

SniperCZE — Sun, 11 Jan 2009 19:45:37 +0100

David Grudl napsal(a):

Šlo, ale v praxi se to nepoužívá.

No nevim, ja to pouzivam docela casto. V sablonach zend_view je to docela uzitecny.

Zápis kódu v tomto fóru (Různé)

David Grudl — Sun, 11 Jan 2009 17:39:44 +0100

SniperCZE napsal(a):

Slo by, aby forum bralo i jednoradkovy kody, tedy <?php echo „lipsum“; ?> ? Tedka musi bejt <?php a ?> na novy radce

Šlo, ale v praxi se to nepoužívá.

K tomuto fóru (Různé)

David Grudl — Sun, 11 Jan 2009 17:13:35 +0100

Nepřehánějte :-) Nahrát pár skriptů na web nestojí za řeč. Děkujte lidem, kteří se o chod fóra budou starat, kteří budou předávat své knowhow a dělit se o rady.

K tomuto fóru (Různé)

piler — Sun, 11 Jan 2009 12:31:49 +0100

Inza napsal(a):

Davide, chci ti moc poděkovat. Myslím že vytvoření tohoto fóra byl velmi dobrý nápad! A velmi dobrý krok vpřed pro podporu PHP komunity u nás. Díky moc!

Pridavam sa k podakovaniu ;)

K tomuto fóru (Různé)

Inza — Sun, 11 Jan 2009 11:01:58 +0100

Davide, chci ti moc poděkovat. Myslím že vytvoření tohoto fóra byl velmi dobrý nápad! A velmi dobrý krok vpřed pro podporu PHP komunity u nás. Díky moc!

Zápis kódu v tomto fóru (Různé)

Tomik — Fri, 09 Jan 2009 13:32:22 +0100

David Grudl napsal(a):

Automatické odkazy nějak nemám rád. Fakt je nutné prolinkovat každou funkci v ukázce zdrojového kódu?

Ale není. Mě to vlastně vůbec nechybí, jen, že mě napadlo, jak vyřešit tento request. :)

Já myslím, že stávající stav je ok.

Zápis kódu v tomto fóru (Různé)

David Grudl — Fri, 09 Jan 2009 13:04:23 +0100

Automatické odkazy nějak nemám rád. Fakt je nutné prolinkovat každou funkci v ukázce zdrojového kódu?

Zápis kódu v tomto fóru (Různé)

Tomik — Fri, 09 Jan 2009 12:53:34 +0100

explain napsal(a):

A co automaticky vkládat odkazy na dokumentaci PHP funkcí ve zvýrazněném kódu? Možná by to byl ale až příliš velký komfort :)

Dal by se na to nasadit JUSH od Jakuba Vrány, který automaticky vytváří i odkazy na dokumentaci PHP a MySQL.

http://jush.sourceforge.net/

Co Ty na to, Davide? :)

Hledám moderátory (Různé)

phx — Thu, 08 Jan 2009 08:25:48 +0100

Tomik napsal(a):

u jiných Davidových fór (doufám, že to skloňuju dobře) nemám moderátorská práva

Ha… zmatl me odkaz administrace v menu:)

No nevim zda bych si forum nejak clenil. Co kdyz jeden z nas bude na dovoleny? Jinak rad bych se drzel toho cemu rozumim a co me bavi. Tz programovani, OOP, MySQL a MsSQL. Ale jak chces. Necham to na tobe.

Hledám moderátory (Různé)

Tomik — Wed, 07 Jan 2009 22:30:17 +0100

Ha, já se špatně zeptal, myslel jsem kdo si vezme jaké části, tohoto fóra, neboť myslím, že by to mělo být rozdělené (částmi myslím ty kategorie jako „Programování“, „Design, frameworky, knihovny“ atd.), u jiných Davidových fór (doufám, že to skloňuju dobře) nemám moderátorská práva, takže předpokládám, že s těmi David nepotřebuje pomoct. :)

The Daily WTF (bizarní kousky programátorů) (Různé)

pmg — Wed, 07 Jan 2009 18:10:35 +0100

Je to ale deprimující, když člověk programuje a kód mu ubývá.

Hledám moderátory (Různé)

phx — Wed, 07 Jan 2009 16:48:54 +0100

Ja osobne sleduji toto forum, nette a dibi a obcas nestiham vsechno cist. Zvlaste po vikendu a tak. Ted je to jeste jedno. Venku je hnusne, ale v lete… No uvidime, treba budeme potrebovat posilu.

I kdyz ted mi dochazi jakou kravinu jsem vypustil. David to zvlada bravurne a to je na to sam:)

The Daily WTF (bizarní kousky programátorů) (Různé)

Tomik — Wed, 07 Jan 2009 16:22:02 +0100

David Grudl napsal(a):

Vynalézavá variace na instanceof …

No, pokud jsou vývojáři odměňováni za kód (ať třeba pochvalou komunity) nikoli kvalitní, ale za kód čím delší, tím lepší, docela tenhle postup chápu. :)

Hledám moderátory (Různé)

Tomik — Wed, 07 Jan 2009 16:19:46 +0100

Tak ještě jedna technická: kdo si vezme jaká fóra? Asi by bylo lepší si to nějak rozdělit, aby v tom byl systém, jinak dojde k tomu, že se budem navzájem překrývat. Mě to je v podstatě jedno.

The Daily WTF (bizarní kousky programátorů) (Různé)

David Grudl — Wed, 07 Jan 2009 12:21:58 +0100

máš recht, jsem ten výřez krapet přeříz.

Hledám moderátory (Různé)

David Grudl — Wed, 07 Jan 2009 12:20:05 +0100

Díky, ale už mám plný stav. Ze zákona. Parkinsonova.

Hledám moderátory (Různé)

Villem — Wed, 07 Jan 2009 10:53:47 +0100

Pokud stále hledáte moderátory tak se dobrovolně hlásím.

The Daily WTF (bizarní kousky programátorů) (Různé)

explain — Wed, 07 Jan 2009 09:20:04 +0100

Pokud je v $this->_slowBackend jméno třídy, tak to smysl má, protože instanceof operátor funguje jenom na objekty. A byl by to (spolu s reflection) použitelný způsob, jak zjistit, že třída implementuje dané rozhraní (např. když jméno třídy dostaneme odněkud dynamicky).

Na druhou stranu, název proměnné $this->_slowBackend moc nenapovídá na to, že by obsahovala jméno třídy :)

Zobrazit nové příspěvky od poslední návštěvy? (Různé)

danaketh — Wed, 07 Jan 2009 01:45:46 +0100

Já mám zase problém s tím, že vidím jako nepřečtené (nové) i příspěvky (fóra), která jsem již četl. No, žíly mi to netrhá :)

Hledám moderátory (Různé)

David Grudl — Wed, 07 Jan 2009 01:03:10 +0100

I stalo se a phx, Tomik a jiriknesl jsou moderátoři. Díky za ochotu!

The Daily WTF (bizarní kousky programátorů) (Různé)

David Grudl — Wed, 07 Jan 2009 00:48:25 +0100

Vynalézavá variace na instanceof

Problémem velkých frameworků je, že občas může do kódu přispět i méně zdatný jedinec. Tento slabší moment jinak kvalitního frameworku mi nedávno ukazoval Martin Mayer:

public function __construct(array $options = array())
{
    ...
    $this->_slowBackend = Zend_Cache::_makeBackend($this->_options['slow_backend'], ...); // vrací objekt
    $this->_fastBackend = Zend_Cache::_makeBackend($this->_options['fast_backend'], ...); // vrací objekt
    if (!in_array('Zend_Cache_Backend_ExtendedInterface', class_implements($this->_slowBackend))) {
        Zend_Cache::throwException('slow_backend must implement the Zend_Cache_Backend_ExtendedInterface interface');
    }
    if (!in_array('Zend_Cache_Backend_ExtendedInterface', class_implements($this->_fastBackend))) {
        Zend_Cache::throwException('slow_backend must implement the Zend_Cache_Backend_ExtendedInterface interface');
    }
    ...
}

The Daily WTF (bizarní kousky programátorů) (Různé)

David Grudl — Wed, 07 Jan 2009 00:46:12 +0100

Narazili jste na nějaké obzvláště vypečené kousky kódu?

Hledám moderátory (Různé)

pmg — Wed, 07 Jan 2009 00:31:31 +0100

Trošku mimo mísu, ale jen poděkuji za vytvoření tohoto fóra. Už dlouho jsem po něm tajně toužil. Na diskusi@jpw imo většina radyschopných vývojářů nechodí, a navíc je poslední dobou dost přetížená. Třeba se jí tímto uleví.

Díky. Díky! DÍKY!

Zobrazit nové příspěvky od poslední návštěvy? (Různé)

Tomik — Wed, 07 Jan 2009 00:00:36 +0100

David Grudl napsal(a):

Vím o tom a oprava je natolik náročná, že by bylo možná snažší napsat nové fórum v Nette :-)

Chápu. Nech to plavat. :) Já budu dělat jakože nic, ok? ;)

A ještě jednou díky za forum, snad se chytí.

Zobrazit nové příspěvky od poslední návštěvy? (Různé)

David Grudl — Tue, 06 Jan 2009 23:51:18 +0100

Vím o tom a oprava je natolik náročná, že by bylo možná snažší napsat nové fórum v Nette :-)

Zobrazit nové příspěvky od poslední návštěvy? (Různé)

Tomik — Tue, 06 Jan 2009 23:48:43 +0100

Zdravím,
mám zde lehký bug, který je ovšem specifický pro všechna fóra od Davida (neboť jsou všechny propojena a předpokládám běží na jedné aplikaci) – a to pokud kliknu na odkaz „Zobrazit nové příspěvky od poslední návštěvy“ zobrazí to příspěvky od poslední návštěvy jakéhokoli fóra ze skupiny fór pro nette, dibi, texy, php, pay-pal, etc (nikoli tedy příspěvky, které přibyly od poslední návštěvy toho konkrétního fóra)… Tzn. že pokud jsem byl na tomto fóru poprvé, zobrazilo mi to 0 nových příspěvků, protože jsem chvilku předtím byl na fóru Nette.

Pokud by to šlo nějak jednoduše opravit a chtělo by se Ti, Davide, budu rád, docela tu fci používám. Pokud ne, nevadí, prostě budu primárně používat RSS, tam ten problém odpadá.

Hledám moderátory (Různé)

Tomik — Tue, 06 Jan 2009 23:43:54 +0100

Zdravím!

Díky moc za skvělý nápad, myslím, že obecné PHP fórum české komunitě opravdu chybělo, tedy nějaké, kde by to opravdu žilo, takže tomuto fóru přeju hodně života!

Vzhledem k tomu, že už takhle trávím poměrně dost času na foru Nette! můžu k tomu přidat i toto fórum, zcela jistě mě to obohatí. A to znamená, že se hlásím do pozice moderátor. :)

Jakého moderátora a v jaké sekci nechám na Tobě, Davide. :)

A teď už dobrou noc!

Zápis kódu v tomto fóru (Různé)

explain — Tue, 06 Jan 2009 20:58:38 +0100

A co automaticky vkládat odkazy na dokumentaci PHP funkcí ve zvýrazněném kódu? Možná by to byl ale až příliš velký komfort :)