Mana komanda mani ienīdīs, bet dokumentācijas izveide/labojumi, visticamākais, būs obligāts čekboksis pie jebkura merge request. Ja nav, tad jāatrakstās, ka toč nav.
@laacz tvītu arhīvs
Sakarā ar to, ka Twitter ir slēdzis bezmaksas piekļuves savam API, šis projekts var tikt uzskatīts par mirušu sākot ar 2023. gada 15. jūniju.
Šis ir tvitera pavediens. No senākā uz svaigāko. Tvītu skaits: 20
@laacz git push origin master
@laacz Atkarājas. Labāk lai ir tickets ar skaidru prasību un MR ir jābūt atsaucei uz ticketu. Uzturēt dokumentāciju kodam, kad evolvē ir tikai čakars, jo doc vienmēr atpaliks no koda, un tas konfuzēs.
@savaadaak @laacz `git push -f origin master`. Lūdzu, nav, par ko.
@Jnis25912490 Ir gadījumi, kad dokumentācija jātur up-to-date. Piemēram, ja ir izmaiņas iekš specenes, ja mainās sistēmas funkcionalitāte, ja nāk klāt integrācijas, utt. Citādi pie tāda apjoma, kāds ir mums, onboardings un aizvietojamība kļūst neiespējami. Mazas lietas, protams, ir mazas.
@laacz Nu jā, skaidrs... to balansu ir grūti noturēt. Sistēma vienmēr dreifē.
@laacz Tak esi lasījis mythical man month?
@savaadaak @laacz Ne jau visi MR autori drīkst komitēt pa tiešo main/master brančā. Pieņemu, ka @laacz gadījumā merdžot iekš main drīkst tikai viņš pats / projekta maintaineris.
@aspruds @savaadaak Nope. Mums ir obligāts review (tīri lai būtu divi acu pāri, bez piekasīšanās), bet merdžot var pats.
@laacz @Jnis25912490 Izklausās pēc ideāla kandidāta BDD
@laacz Jo tālāk fiziski dokumentācija atrodas no koda, jo mazāka vēlme to aktualizēt līdz ar koda izmaiņām. Kur nu vēl atcerēties tās atrašanās vietu!
@laacz Es sāktu ar to, ka iedotu problēmu komandai - "ir šāda situācija, kas izraisa šādas sekas, ko mēs varam darīt, lai tā nebūtu". Empower the team to own the product. Varbūt viņiem ir out of the box risinājums.
@laacz Tā vietā lai iedotu risinājumu, iedod viņiem problēmu.
@laacz Man šis attēls ļoti patīk : https://www.agilecentre.com/resources/article/creating-alignment-and-autonomy/
@Sidraba Es piekrītu. Šis daļēji arī ir komandas risinājums. No manas puses vēl atliek atrisināt jautājumu par to, lai dokumentācija nav jāmeklē, bet tā ir organiska. Jaunajā lomā 20 gadu legacy kārtošana nav viegli pat tad, ja viss strādā un ir daļēji dokumentēts :)
@AndrisSaukums Protams, tas ir pirmais risināmais jautājums :)
@laacz Īsti gan nesaskatu par ko ienīst, zinu programētāji vispār totāli slinka tauta it sevišķi uz dokumentācijas rakstīšanu, bet ja ir vairāk par 2 komandā, tad tā ir nepieciešama.
@laacz Var tavā komandā? :D Vienmēr esmu gribējis nebūt vienīgais, kurš cenšas dokumentēt :D
@raimis001 Zini, dokumentācijai ir vairāki līmeņi. Kodam vairumā gadījumu dokumentācija nav nepieciešama. readme, komentāri, loģiska un visiem saprotama struktūra, vispārpieņemti koncepti. Sistēmām, savukārt, jau ir cita lieta.