{"id":35419,"date":"2019-10-31T22:04:14","date_gmt":"2019-10-31T19:04:14","guid":{"rendered":"https:\/\/prohoster.info\/blog\/ispolzujte-git-pri-dokumentirovanii\/"},"modified":"2019-10-31T22:04:14","modified_gmt":"2019-10-31T19:04:14","slug":"ispolzujte-git-pri-dokumentirovanii","status":"publish","type":"post","link":"https:\/\/prohoster.info\/sq\/blog\/administrirovanie\/ispolzujte-git-pri-dokumentirovanii","title":{"rendered":"P\u00ebrdorni GIT n\u00eb dokumentim","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Nganj\u00ebher\u00eb jo vet\u00ebm dokumentacioni vet\u00eb, por edhe procesi i pun\u00ebs mbi t\u00eb mund t\u00eb jet\u00eb kritik. P\u00ebr shembull, n\u00eb rastet e projekteve, pjesa m\u00eb e madhe e pun\u00ebs \u00ebsht\u00eb e lidhur sakt\u00ebsisht me p\u00ebrgatitjen e dokumentacionit, dhe nj\u00eb proces i gabuar mund t\u00eb \u00e7oj\u00eb n\u00eb gabime dhe madje n\u00eb humbje informacioni, dhe, p\u00ebr rrjedhoj\u00eb, n\u00eb humbje koh\u00eb dhe p\u00ebrfitimi. Por edhe n\u00ebse ky tem\u00eb nuk \u00ebsht\u00eb qendrore n\u00eb pun\u00ebn tuaj dhe ndodhet n\u00eb periferin\u00eb, akoma nj\u00eb proces i sakt\u00eb mund t\u00eb p\u00ebrmir\u00ebsoj\u00eb cil\u00ebsin\u00eb e dokumentit dhe t'ju kursej\u00eb koh\u00eb.<\/p>\n

Qasja e p\u00ebrshkruar k\u00ebtu, me shembullin e nj\u00eb zbatimi konkret<\/a><\/noindex>, ka nj\u00eb nivel t\u00eb ul\u00ebt hyrjeje. Teknikisht, mund t\u00eb filloni t\u00eb punoni ndryshe, q\u00eb nes\u00ebr.
\n<\/a><\/noindex><\/p>\n

Vendosja e detyr\u00ebs<\/h3>\n

\nJu duhet t\u00eb krijoni nj\u00eb dokument ose nj\u00eb set dokumentesh. Ndoshta \u00ebsht\u00eb dokumentacioni i projektit ose protokollimi i rrjetit tuaj, ose di\u00e7ka m\u00eb e thjesht\u00eb, p\u00ebr shembull, ju duhet t\u00eb p\u00ebrshkruani proceset n\u00eb kompanin\u00eb tuaj ose n\u00eb departamentin tuaj. P\u00ebr t\u00eb th\u00ebn\u00eb n\u00eb p\u00ebrgjith\u00ebsi, b\u00ebhet fjal\u00eb p\u00ebr \u00e7do dokument ose grup dokumentesh me tekst, imazhe, tabela... Le ta komplikohemi k\u00ebt\u00eb detyr\u00eb sepse <\/p>\n

    \n
  1. kjo pun\u00eb parashikon bashk\u00ebpunim, p\u00ebrpjekje nga nj\u00eb grup ose disa grupe punonj\u00ebsish<\/li>\n
  2. n\u00eb fund do t\u00eb d\u00ebshironit t\u00eb keni nj\u00eb dokument n\u00eb nj\u00eb format t\u00eb caktuar, me atributet e stilit korporativ, i krijuar sipas nj\u00eb shablloni t\u00eb caktuar. P\u00ebr sakt\u00ebsi, do t\u00eb supozojm\u00eb se \u00ebsht\u00eb MS Word (.docx)<\/li>\n<\/ol>\n

    \nPara 10 vjet\u00ebsh, qasja do t\u00eb ishte e qart\u00eb: do t\u00eb krijonim nj\u00eb dokument ose dokumente MS Word dhe ndonj\u00ebher\u00eb do ta organizonim pun\u00ebn p\u00ebr ndryshime. <\/p>\n

    Dhe kjo qasje \u00ebsht\u00eb ende n\u00eb fuqi. Kjo p\u00ebrdoret gjithashtu nga integrator\u00ebt e m\u00ebdhenj p\u00ebr krijimin e dokumentacionit t\u00eb projekteve. Por intuitivisht kuptohet se, n\u00ebse v\u00ebrtet punoni intensivisht, me shum\u00eb ndryshime dhe diskutime, p\u00ebr nj\u00eb periudh\u00eb t\u00eb gjat\u00eb mbi nj\u00eb dokument, kjo qasje nuk \u00ebsht\u00eb shum\u00eb e shkath\u00ebt.<\/p>\n

    Shembuj<\/b><\/p>\n

    E ndjeva fort k\u00ebt\u00eb problem nd\u00ebrsa punoja n\u00eb nj\u00eb integrator t\u00eb madh. Procesi i ndryshimit t\u00eb dokumentacionit t\u00eb projektit ishte si n\u00eb vazhdim:<\/p>\n

      \n
    1. inxhinieri shkarkon versionin m\u00eb t\u00eb fundit t\u00eb dokumentit MS Word (.docx)<\/li>\n
    2. ndryshon emrin<\/li>\n
    3. b\u00ebn ndryshime n\u00eb modin track<\/li>\n
    4. d\u00ebrgon dokumentin me ndryshime te arkitekti<\/li>\n
    5. po ashtu d\u00ebrgon nj\u00eb list\u00eb t\u00eb t\u00eb gjitha korrigjimeve me komente<\/li>\n
    6. arkitekti analizon ndryshimet<\/li>\n
    7. n\u00ebse gjith\u00e7ka \u00ebsht\u00eb n\u00eb rregull, ai kopjon ndryshimet n\u00eb skedarin me versionin m\u00eb t\u00eb fundit, nd\u00ebrron versionin, e ngarkohet n\u00eb burimin e p\u00ebrbashk\u00ebt<\/li>\n
    8. n\u00ebse ka v\u00ebrejtje, inicohet nj\u00eb diskutim (email ose takime)<\/li>\n
    9. arrihet nj\u00eb konsensusi<\/li>\n
    10. pastaj pikat 3 - 9<\/li>\n<\/ol>\n

      \nNd\u00ebrsa puna nuk ishte intensive, kjo funksiononte ndonj\u00eb m\u00ebnyr\u00eb. Por n\u00eb nj\u00eb moment t\u00eb caktuar, ky proces u b\u00eb ngushti kryesor i nj\u00eb projekti t\u00eb t\u00ebr\u00eb dhe solli probleme. Problemi ishte q\u00eb \u00e7do gj\u00eb b\u00ebhet e keqe sapo ndryshimet b\u00ebhen shpesh dhe ndodhen paralelisht nga disa ekipe.<\/p>\n

      K\u00ebshtu, kur kaluam n\u00eb faz\u00ebn e testimit paraprak, filluan t\u00eb shfaqen probleme t\u00eb ndryshme dhe, ndon\u00ebse ishin t\u00eb vogla, por ishte nevoja t\u00eb ndryshoheshin dokumentet shpesh - kat\u00ebr ekipe t\u00eb ndryshme, \u00e7do dit\u00eb, pothuajse n\u00eb t\u00eb nj\u00ebjt\u00ebn koh\u00eb, me diskutime. T\u00eb gjitha k\u00ebto ndryshime kalonin p\u00ebrmes nj\u00eb inxhinieri - arkitetkti. Skeda me dizajnin e projektit ishte e madhe, dhe si rrjedhoj\u00eb, arkitekti ishte i mbingarkuar me pun\u00eb rutinore t\u00eb lidhura me kopjimin dhe redaktimin t\u00eb madhe, b\u00ebnte shum\u00eb gabime, duhej t\u00eb kontrollonte gjith\u00e7ka, t\u00eb riposlisi, dhe n\u00eb p\u00ebrgjith\u00ebsi kjo ishte af\u00ebr kaosit. <\/p>\n

      N\u00eb k\u00ebt\u00eb rast, qasja, qasja e pun\u00ebs mbi dokumentin MS Word, punonte me shum\u00eb v\u00ebshtir\u00ebsi dhe krijonte probleme.<\/p><\/blockquote>\n

      <\/p>\n

      Git, Markdown<\/h3>\n

      \nDuke u p\u00ebrballur me problemin e p\u00ebrshkruar n\u00eb shembullin e m\u00ebsip\u00ebrm, fillova t\u00eb shqyrtoj k\u00ebt\u00eb \u00e7\u00ebshtje.
      \nPash\u00eb se gjithnj\u00eb e m\u00eb shum\u00eb po b\u00ebhej e zakonshme t\u00eb p\u00ebrdorej       Markdown<\/a><\/noindex> n\u00eb kombinim me Git<\/a><\/noindex> n\u00eb krijimin e dokumenteve.<\/p>\n

      Git \u00ebsht\u00eb nj\u00eb mjet p\u00ebr zhvillim. Por pse t\u00eb mos e p\u00ebrdorim at\u00eb p\u00ebr procesin e dokumentimit? N\u00eb k\u00ebt\u00eb rast, \u00e7\u00ebshtja e pun\u00ebs shum\u00ebp\u00ebrdoruesve zgjidhet. Por p\u00ebr t\u00eb shfryt\u00ebzuar plot\u00ebsisht mund\u00ebsit\u00eb e Git, na nevojitet nj\u00eb format tekstual dokumenti, na nevojitet t\u00eb gjejm\u00eb nj\u00eb mjet tjet\u00ebr, jo MS Word, dhe p\u00ebr k\u00ebto q\u00ebllime Markdown \u00ebsht\u00eb i p\u00ebrshtatsh\u00ebm. <\/p>\n

      Markdown \u00ebsht\u00eb nj\u00eb gjuh\u00eb e thjesht\u00eb e p\u00ebrshkrimit t\u00eb tekstit. Ajo \u00ebsht\u00eb e destinuar p\u00ebr t\u00eb krijuar tekste t\u00eb bukura n\u00eb skedar\u00ebt e zakonsh\u00ebm me format TXT. N\u00ebse krijojm\u00eb dokumentet tona n\u00eb Markdown, at\u00ebher\u00eb lidhja Markdown - Git duket natyrale.<\/p>\n

      Dhe \u00e7do gj\u00eb do t\u00eb ishte n\u00eb rregull, dhe n\u00eb k\u00ebt\u00eb pik\u00eb do t\u00eb ishte e mundshme t\u00eb vendosej nj\u00eb pik\u00eb, sikur t\u00eb mos e kishim kushtin ton\u00eb t\u00eb dyt\u00eb: \"n\u00eb dalje na nevojitet nj\u00eb dokument n\u00eb nj\u00eb format t\u00eb caktuar, me atributet e stilit korporativ, i krijuar sipas nj\u00eb shablloni t\u00eb caktuar\" (dhe u dakorduam n\u00eb fillim, se p\u00ebr qart\u00ebsi kjo do t\u00eb jet\u00eb MS Word). K\u00ebshtu, n\u00ebse vendos\u00ebm t\u00eb p\u00ebrdorim Markdown, na nevojitet nj\u00eb m\u00ebnyr\u00eb p\u00ebr t\u00eb konvertuar k\u00ebt\u00eb skedar n\u00eb formatin .docx q\u00eb k\u00ebrkohet.<\/p>\n

      Ekzistojn\u00eb programe konvertimi midis formateve t\u00eb ndryshme, p\u00ebr shembull, Pandoc<\/a><\/noindex>.
      \nJu mund t\u00eb konvertoni skedarin Markdown n\u00eb format .docx me k\u00ebt\u00eb program.
      \nMegjithat\u00eb, \u00ebsht\u00eb e r\u00ebnd\u00ebsishme t\u00eb kuptohet se, p\u00ebrve\u00e7 t\u00eb tjerash, jo \u00e7do gj\u00eb q\u00eb \u00ebsht\u00eb n\u00eb Markdown do t\u00eb konvertohet n\u00eb MS Word dhe, p\u00ebr m\u00eb tep\u00ebr, MS Word \u00ebsht\u00eb nj\u00eb vend i t\u00ebr\u00eb krahasuar me qytetin e rregullt q\u00eb \u00ebsht\u00eb Markdown. Ka nj\u00eb sasi t\u00eb madhe gj\u00ebrash q\u00eb gjenden n\u00eb Word dhe nuk ekzistojn\u00eb n\u00eb asnj\u00eb form\u00eb n\u00eb Markdown. Nuk mund t\u00eb merrni thjesht skedarin dhe me disa \u00e7el\u00ebsa t\u00eb Pandoc ta konvertoni formatin tuaj Markdown n\u00eb pamjen e d\u00ebshiruar MS Word. Prandaj, zakonisht, pas konvertimit, nevojitet \"p\u00ebrpunimi\" i dokumentit .docx t\u00eb marr\u00eb manualisht, gj\u00eb q\u00eb gjithashtu mund t\u00eb jet\u00eb e kushtueshme n\u00eb aspektin e koh\u00ebs dhe t\u00eb \u00e7oj\u00eb n\u00eb gabime.<\/p>\n

      N\u00ebse do t\u00eb ishim n\u00eb gjendje t\u00eb shkruanim nj\u00eb skript q\u00eb automatikisht \"p\u00ebrfundonte\" at\u00eb q\u00eb Pandoc nuk e kishte b\u00ebr\u00eb - do t\u00eb ishte nj\u00eb zgjidhje ideale.<\/p>\n

      Duke pasur parasysh se funksionaliteti i MS Word dhe Markdown nuk \u00ebsht\u00eb identik n\u00eb terma t\u00eb p\u00ebrgjithsh\u00ebm, un\u00eb mendoj se zgjidhja e k\u00ebsaj detyre \u00ebsht\u00eb e pamundur, por a mund t\u00eb b\u00ebhet kjo p\u00ebr situata specifike, p\u00ebr k\u00ebrkesa specifike? Eksperienca ime ka treguar se po, \u00ebsht\u00eb e mundur dhe ndoshta p\u00ebr shum\u00eb, ose mund t\u00eb jet\u00eb madje p\u00ebr shumic\u00ebn e situatave. <\/p>\n

      Zgjidhja e nj\u00eb detyre t\u00eb ve\u00e7ant\u00eb<\/h3>\n

      \nPra, n\u00eb rastin tim, pas konvertimit t\u00eb skedarit me ndihm\u00ebn e Pandoc, m\u00eb duhej t\u00eb b\u00ebja p\u00ebrpunim t\u00eb m\u00ebtejsh\u00ebm manual t\u00eb skedar\u00ebve, konkretisht<\/p>\n