Pavlovy poznamky prepsany na faq

diff --git a/cviceni.mdwn b/cviceni.mdwn
index 383551a1c9616ec0458ace816ffe76d72a25b356..dd2949825b2012eebb735942ff87b721c9242b42 100644 (file)
--- a/cviceni.mdwn
+++ b/cviceni.mdwn
@@ -58,6 +58,8 @@ požadavky správců.
 Pokud nevíte jaký projekt si vybrat, můžete zkusit některý z
 [[našeho seznamu|cviceni/projekty]].
 
+Při práci na projektech vám můžou pomoct [[odpovědi na často kladené otázky|faq]].
+
 Vlastní projekt
 ------------
 

diff --git a/faq/index.mdwn b/faq/index.mdwn
new file mode 100644 (file)
index 0000000..ccd1841
--- /dev/null
+++ b/faq/index.mdwn
@@ -0,0 +1,111 @@
+[[!meta title="FAQ"]]
+[[!meta stylesheet="faq/local" rel="stylesheet"]]
+
+(často kladené otázky a odpovědi)
+
+[[!toc levels=2]]
+
+## Proč zde nemůžu editovat svou stránku i když se zaloguju?
+
+Musíte použít nový login tj. stejný jako je jméno vaší stránky. Pokud
+nevíte heslo, najdete ho na <http://service.felk.cvut.cz/heslo>
+v kolonce *Počáteční heslo FELK*.
+
+## Vývojáři se mnou nekomunikují nebo nechtějí mé změny přijmout i když by to projektu prospělo. Mám založit fork?
+
+Založení vlastního forku projektu je možnost, která je ve škále
+možností celkem na konci seznamu a připadá především v úvahu, pokud se
+s původními správci nelze dohodnout nebo pokud vám založení vlastní
+větve sami doporučí.
+
+Založit vážně míněný fork cizího projektu, který budete publikovat na
+serverech typu [SF.net][sf] nebo [Freshmeat.net][fm] by mělo být pouze
+závažně míněné rozhodnutí s tím, že se míníte
+o vývoj dané varianty nebo celého projektu starat delší dobu
+a převezmete na sebe odpovědnost s řešením chyb, tvorbou dokumentace a
+správou projektu.
+
+## Nenaštvu vývojáře, když publikuju svůj fork v gitu na repo.or.cz?
+
+Lehký/personální branch na [git.or.cz](http://git.or.cz) nebo jinde
+pro osobní účely je naopak věc zcela jiná, jedná se jen o zveřejnění
+vlastního pískoviště (sandboxu) druhým, aby mohli sledovat, co děláte.
+V takovém případě není vyjednávání s hlavními autory příliš nutné, ale
+je potřeba pří posílání odkazů uvádět, že se jedná je o váš soukromý
+fork s tím, že míníte práci integrovat do hlavní větve.
+
+[sf]:http://sf.net
+[fm]:http://freshmeat.net
+
+## Vývojáři mi nechtějí dát právo zapisovat do jejich repozitáře. Jak s nimi mám spolupracovat?
+
+Pokud je vám povolen přístup do cizího projektu (např. na
+[SF.net][sf]), tak to je projev značné důvěry správců projektu.
+V mnoha projektech ale vývoj probíhá následujícím způsobem, kdy je
+celkem jedno sedli právo zápisu máte nebo ne.
+
+Vývojář (vy) pošle navržené změny do konference (mailing list)
+projektu jako patch proti aktuálnímu stavu v repozitáři. Patch, pokud
+není extrémně velký, by měl být čistý text přímo vložený do těla
+e-mailu. Žádné HTML formátování zprávy a přílohy. Pozor, množství
+MUA/e-mail programů automaticky volí HTML či mění mezery za tabelátory
+a naopak. Nepoužívejte takový nebezpečný SW. Takto zaslané patche mají
+výhodu, že v odpovědi lze připsat poznámky ke konkrétnímu místu patche.
+Po prodiskutování a schválení vašich změn je pak patche "commitnout"
+do repozitáře. Pokud máte právo, uděláte to vy, jinak to udělá někdo
+jiný.
+
+## Projekt používá verzovací systém, se kterým neumím/nechci pracovat. Co s tím?
+
+Při práci s cizím projektem je správné se přizpůsobit typu repositáře,
+ve kterém je projekt veden. Některé verzovací systémy (např. git)
+umožňují import a export do jiných systémů, takže lokálně můžete
+používat váš oblíbený systém a nikdo jiný o tom nemusí vědět.
+
+## Projekt ještě stále používá CVS. Pomoc!!!
+
+Verzovací systém CVS má mnoho nevýhod. Zaprvé se verzují jednotlivé
+soubory a ne projekt jako celek, takže není jasné jestli spolu změny
+ve dvou souborech nějak souvisí. Zadruhé není možno přímo držet
+lokální stav včetně historie a postupně "pushovat" své změny do
+centrálního repositáře, pokud jsou projektem schváleny.
+
+S CVS tedy pracujete buď tak, že si aktuální stav stáhnete
+
+    cvs up -d
+
+uděláte úpravy a vygenerujete patch přes všechny vaše změny
+
+    cvs diff -u -N -p > moje-zmena.patch
+
+Po schválení celý patch pošlete do repositáře
+
+    cvs commit
+
+Pokud je práci výhodné pro účely diskuze a dokumentování rozdělit na
+více samostatných změn, tak můžete nasadit
+[quilt patch stack nad CVS](http://savannah.nongnu.org/projects/quilt).
+Pokud je práce ještě více, tak je pak asi nejvýhodnější použít import
+do GITu. Takto jsme třeba importovali do GITu jeden z našich projektů:
+
+    export CVS_RSH=ssh
+    CVSROOT=":ext:ppisa@ulan.cvs.sourceforge.net:/cvsroot/ulan"
+    CVSMODULE="ulan"
+
+    git cvsimport -v -d $CVSROOT -C ulan-devel -i -k -a -r ulan-sf $CVSMODULE
+
+Pak pracovat v GITu a posléze použít `git format-patch` a patche
+prodiskutovat a po schválení buď ručně naaplikovat a nacommitovat po jednom
+na CVS nebo použít `git cvsexportcommit`.
+
+Rozsah studentské práce asi většinou nebude takto komplexní řešení vyžadovat.
+Stačí většinou poslat jeden kompletní patch.
+
+# Mám posílat své commity na Ohloh nebo do repozitáře na SourceForge?
+
+Pracovat a commitovat budete typicky na [SF.net][sf]. [Ohloh][o] je
+pouze monitor. Pokud se vám podaří změnu dostat na [SF.net][sf], tak
+se commit automaticky objeví na [Ohloh][o] s vaším loginem na SF.net a
+vy si ho pak přiřadíte k vašemu účtu.
+
+[o]:http://ohloh.net

diff --git a/faq/local.css b/faq/local.css
new file mode 100644 (file)
index 0000000..148c779
--- /dev/null
+++ b/faq/local.css
@@ -0,0 +1,19 @@
+.toc {
+  line-height: inherit;;
+  width: 100%;
+  float: none;
+  margin: 0 0 0 inherit;
+  padding: 0;
+  background: inherit;
+  border: inherit;
+  -moz-border-radius: inherit;
+}
+
+.toc ol {
+  margin: 0;
+  padding:0;
+}
+
+.toc li {
+  margin-bottom: 0.5ex;
+}

diff --git a/index.mdwn b/index.mdwn
index a4c10a2fbf28be5ac3829dbc393cf507096e2a19..5b9fff8f04a3d59d491dbdccc8c64cea2b2e3b2e 100644 (file)
--- a/index.mdwn
+++ b/index.mdwn
@@ -17,6 +17,7 @@ popsaných technik ve vestaěvných aplikacích a pro řízení v reálném
 Aktuality
 =========
 
+* *11. března 2010*: Přidány [[FAQ|faq]].
 * *7. března 2010*: Opravena chyba znemožňující přidávání komentářů s diakritikou; přidány odkazy na historii stránek; přidán kontakt na webmastera.
 * Ve dnech 6. a 7. března proběhne na Strahově konference a setkání [install fest](http://www.installfest.cz/if10/).
 

diff --git a/poznamky.mdwn b/poznamky.mdwn
deleted file mode 100644 (file)
index de78b47..0000000
--- a/poznamky.mdwn
+++ /dev/null
@@ -1,90 +0,0 @@
-[[!meta title="Poznámky a odkazy"]]
-
-Poznámky k práci s cizím OSS projektem
-=====================================
-
-Při práci s cizím projektem je správné se přizpůsobit typu
-repositáře, ve kterém je projekt veden. Založení vlastního
-forku projektu je možnost, která je ve škále možností celkem
-na konci seznamu možností a připadá především v úvahu, pokud se
-s původními správci nelze dohodnout nebo pokud vám založení
-vlastní větve sami doporučí. Založit vážně míněný fork cizího
-projektu, který budete publikovat na [SF.net][sf] nebo [Freshmeat.net][fm]
-by mělo být pouze závažně míněné rozhodnutí s tím, že se míníte
-o vývoj dané varianty nebo celého projektu starat delší dobu
-a převezmete na sebe odpovědnost s řešením chyb, tvorbou dokumentace
-a správou projektu.
-
-[sf]:http://sf.net
-[fm]:http://freshmeat.net
-
-Lehký/personální branch v [git.or.cz](http://git.or.cz) nebo jinde pro
-osobní účely je naopak věc zcela jiná, jedná se jen o zveřejnění
-vlastního pískoviště (sandboxu) druhým, aby mohli sledovat,
-co děláte. V takovém případě není vyjednávání s hlavními autory
-příliš nutné, ale je potřeba pří posílání odkazů uvádět, že se
-jedná je o váš soukromý fork s tím, že míníte práci integrovat
-do hlavní větve.
-
-Pokud je vám například povolen i přístup do cizího projektu
-na SF.net, tak to je projev značné důvěry zakladatelů
-projektu. Je správné se dohodnout s nimi. Dále budeme uvažovat
-repozitář projektu ve verzovacím systému CVS.
-
-Když musíte pracovat s CVS
---------------------------
-
-Optimální postup je poslat navržené změny do konference (mailing list) projektu jako patch
-proti aktuálnímu stavu CVS. Patch, pokud není extrémně velký, by měl být
-čistý text přímo vložený do těla e-mailu. Žádné HTML formátování
-zprávy a přílohy. Pozor, množství MUA/e-mail programů automaticky
-volí HTML a mění mezery za tabelátory a naopak. Nepoužívejte
-takový nebezpečný SW. Po prodiskutování a schválení s vývojáři
-pak pošlete změny přímo do repositáře nebo o to požádáte některého
-z vývojářů s právem zápisu. Pokud se jedná o CVS, tak ta má dost nevýhodu
-v tom, že vám neumožňuje přímo držet lokální stav včetně
-historie a postupně "nacommitovat" své změny do svého repositáře,
-vygenerovat patche a po sválení změny "pushnout" do centrálního
-repositáře. S CVS tedy pracujete buď tak, že si aktuální stav stáhnete,
-děláte úpravy a případné změny z centrálního repositáře
-do svého pracovního prostoru. Stahujete
-
-    cvs -z3 up -d
-
-Patch vygenerujete přes všechny vaše změny
-
-    cvs -z3 diff -u -N -p
-
-Po schválení celý patch pošlete do repositáře
-
-    cvs -z3 commit
-
-Pokud je práci výhodné pro účely diskuze a dokumentování
-rozdělit na více samostatných změn, tak můžete nasadit
-quilt patch stack nad CVS http://savannah.nongnu.org/projects/quilt
-Pokud je práce ještě více, tak je pak asi nejvýhodnější použít
-import do GITu. Takto jsme třeba importovali do GITu jeden
-z našich projektů:
-
-    export CVS_RSH=ssh
-    CVSROOT=":ext:ppisa@ulan.cvs.sourceforge.net:/cvsroot/ulan"
-    CVSMODULE="ulan"
-
-    git cvsimport -v -d $CVSROOT -C ulan-devel -i -k -a -r ulan-sf $CVSMODULE
-
-Pak pracovat v GITu a posléze použít `git format-patch` a patche
-prodiskutovat a po schválení buď ručně naaplikovat a nacommitovat po jednom
-na CVS nebo použít `git cvsexportcommit`.
-
-Rozsah studentské práce asi většinou nebude takto komplexní řešení vyžadovat.
-Stačí většinou poslat jeden kompletní patch.
-
-Vztah SourceForge a Ohlohu
---------------------------
-
-Pracovat a commitovat budete typicky na [SF.net[sf]. [Ohloh][o] je pouze monitor.
-Pokud se vám podaří změnu dostat na [SF.net][sf], tak se commit objeví
-na [Ohloh][o] s vaším loginem na SF.net a vy si ho pak přiřadíte
-k vašemu účtu.
-
-[o]:http://ohloh.net

diff --git a/sidebar.mdwn b/sidebar.mdwn
index 6bec85f9c29a6d5a7f4c604624815e1ec379499c..1a2a9dba570926212aed0b4f896a51ac798bfaaf 100644 (file)
--- a/sidebar.mdwn
+++ b/sidebar.mdwn
@@ -2,4 +2,3 @@
 * [[Přednášky|prednasky]]
 * [[Cvičení|cviceni]]
 * [[Studenti|student/2010]]
-* [[Poznámky|poznamky]]