Blame view

README.md 2.22 KB
a896adde   Görcsös Zoltán   Update readme.md
1
2
  *#mainteiner:* @zgorcsos
  
84318e82   Görcsös Zoltán   Readme szerkesztése
3
  ![][#headerpic]
157cb697   Görcsös Zoltán   readme.md tartalo...
4
5
  
  # devprocdoc = Developer Process Documentation
84318e82   Görcsös Zoltán   Readme szerkesztése
6
  > A repository alatt vezetjük a Vrh fejlesztési folyamatainak dokumentációját.
157cb697   Görcsös Zoltán   readme.md tartalo...
7
  
84318e82   Görcsös Zoltán   Readme szerkesztése
8
  ## Szabályok:
157cb697   Görcsös Zoltán   readme.md tartalo...
9
10
  * A dokumentáció **kizárólag** markdown alapú!
  * A dokumentáció organizációja **könyvtárakra** törve történik
42f0eebd   Görcsös Zoltán   add picture refer...
11
12
  * Az MD fájlokban használt képeket a **web.vonalkod.hu** ftp szerveren a fejlesztes/devprocdoc alá kell feltölteni. Az ftp elérési módja [ezen][#webvonalkodhuftp] a Redmine tudástár oldalon található. Az ide feltöltött fájlokat a http://web.vonalkod.hu/fejlesztes/devprocdoc/továbbiútvonal/fájlnév formában hivatkozuk a dokumentációban. Az ftp szerveren a devprocdoc repoisitory-val egyező könyvtár struktúrát kell kialakítani a devprocdoc könyvtár alatt!
  * A fenti feltöltött, és az md fájlokban hivatkozott képeket a repository-hoz is hozzáadjuk!
a896adde   Görcsös Zoltán   Update readme.md
13
  * A diskurzus a dokumentációk tartalmáról **kizárólag** itt történik! 
84318e82   Görcsös Zoltán   Readme szerkesztése
14
      * Használd a beépített **Issue tracckert**
a896adde   Görcsös Zoltán   Update readme.md
15
16
      * A **commitok** megjegyzés hozzáfűzési lehetőségét
      * Továbbá az alább leírt szerkesztési szabályokat és a Merge request-ek rendszerét, az azokban végezhető kommentelési lehetőségeket
42f0eebd   Görcsös Zoltán   add picture refer...
17
      * A kommunikációban preferáld az említések, és hivatkozások használatát
84318e82   Görcsös Zoltán   Readme szerkesztése
18
  * A project open, hogy a dokumentáció a közvetlen gitlab.vonalkod.hu alatti linkkel egyszerűen meg lehessen osztani **bárkivel**.
42f0eebd   Görcsös Zoltán   add picture refer...
19
  * Mivel a fő megjelenítőnk a gitlab, ezért *GitLab Flavored Markdown*-t használunk. A cél, hogy a gitlab [kiszólgálónkon][#ourgitlab] jól nézzen ki. GFM-ről dokumentáció [itt][#gitlabmddoc]
84318e82   Görcsös Zoltán   Readme szerkesztése
20
21
  * Jó offline MD szerkesztő: [Markdown Monster][#markdownmonster]
  * Vagy egyszerűen használd a gitlab beépített markdown editorát... 
157cb697   Görcsös Zoltán   readme.md tartalo...
22
  
84318e82   Görcsös Zoltán   Readme szerkesztése
23
24
  > # **Follow the rules!**
  
42f0eebd   Görcsös Zoltán   add picture refer...
25
26
27
  [#headerpic]: <http://web.vonalkod.hu/fejlesztes/devprocdoc/rules.png>
  [#webvonalkodhuftp]:<http://redmine.vonalkod.hu/projects/vrhfejlesztes/wiki/Bels%C5%91_h%C3%A1l%C3%B3zat#VRH-infrastrukt%C3%BAra-WebSzolg%C3%A1ltat%C3%A1sok-elr%C3%A9%C3%A9sei>
  [#ourgitlab]:<http://gitlab.vonalkod.hu:443/vrh/devprocdoc>
84318e82   Görcsös Zoltán   Readme szerkesztése
28
  [#gitlabmddoc]: <https://gitlab.com/help/user/markdown>
42f0eebd   Görcsös Zoltán   add picture refer...
29
  [#markdownmonster]: <https://markdownmonster.west-wind.com/download.aspx>