Pitanje:
Trebam li prijaviti svoje kontrolne liste kao dokumentaciju?
Rarity
2012-04-13 21:04:52 UTC
view on stackexchange narkive permalink

Vodim puno malih popisa obveza. Držao sam ih na legalnoj podlozi i bacao sam stranice kad su završili. Sada koristim iPad aplikaciju, tako da se moja povijest uvijek pohranjuje, ali je ne pohranjujem u bilo kojem obliku službene dokumentacije.

Ja sam programer pa se većina mog rada dokumentira putem kontrole verzija , ali postoji puno malih popravaka softvera koji nije kontroliran verzijom, promjena baze podataka i pregleda koje radim dok ispunjavam i neku vrstu podrške.

Pokušavamo dokumentirati što radimo u mom odjelu više mi se sinula ideja, ali moje promjene nisu one koje uzrokuju probleme.

Trebam li popis zadataka zadržati kao neku vrstu službene dokumentacije? Kako bih se uvjerio da je to zapravo korisno za nekoga drugog osim mene?

Zašto promjene baze podataka ne bi bile u kontroli izvora? A zašto ne biste provjerili skripte koje koristite za preglede?
@HLGEM Radim na tome da to započnem, ali ovdje se ne radi samo o stvarima iz baze podataka
Sedam odgovori:
#1
+8
Tech Lover in NYC
2012-04-14 09:00:07 UTC
view on stackexchange narkive permalink

Zvuči kao da vaš odjel pokušava bolje pratiti tko što radi i što radi, pa bih prema tome rekao da da, trebali biste ih voditi. Ipak, zvuči kao da u formatu u kojem su, neće biti korisni mnogim drugim ljudima, jer mogu biti slučajne zbirke velikih i malih zadataka s malo povezanih informacija ili oznaka.

Ako postoji zajednički je napor vašeg odjela za praćenje i dokumentiranje više, zvuči kao da je dobro vrijeme za početak korištenja softvera za to. Jedna od ogromnih blagodati korištenja usluge poput Fogbugz, Teambox, Trello, Pivotal Tracker, itd., Jest ta što sve što radite postaje dostupno za pretraživanje i vama i svim trenutnim ili budućim članovima tima. Želite li vidjeti kada se netko prvi put bavio određenim problemom ili ako se često pojavljuje? Potražite ga i pogledajte što će se pojaviti.

Osobno sam implementirao Teambox na svoje radno mjesto i potičem svoje suradnike da ga koriste za suradničke zadatke. Ali i sam ga koristim za stvari koje samo ja trebam pratiti, znajući da onaj tko bude u mojoj ulozi u budućnosti (čak i ako sam to ja!) Može cijeniti ovu povijest kako su se prije rješavale određene stvari.

Mnogi od ovih sustava prilično su brzi i jednostavni za upotrebu, a integriraju tok komentiranja i čine da se ažuriranja i rasprave oko zadatka pohranjuju s tim zadatkom. Također, ako postoje ponovljivi popisi zadataka, mnogi od ovih sustava omogućuju vam pohranu kao predložak.

Upotrijebite sustav tiketa (koji se naziva i praćenje problema: poput Trello, Jira ... itd.).
#2
+6
Brandon
2012-04-13 21:59:26 UTC
view on stackexchange narkive permalink

Imao sam istu situaciju kod svog prethodnog poslodavca. Na kraju sam tek počeo pisati u našem wikiju svaki put kad bih imao novo ne trivijalno pitanje podrške s kojim sam se morao nositi. Bilo je pomalo prosvjetljujuće, jer je postojala značajna količina informacija koje sam upravo usvojio. Čak i sitni problemi stvarno pretpostavljaju da imate barem neku razinu institucionalnog znanja.

To je muka učiniti kad započnete, ali poslije je nekako lijepo jer možete uzeti odmor i možda nabaviti jedan telefon nazovite umjesto 3-4 dnevno. :)

To zvuči puno više od običnog kontrolnog popisa.
Volio bih da imamo Wiki, nekako mi se svidjela ideja wikija u sustavu za prodaju karata. Sve što imamo su užasno poredani word dokumenti
@FrustratedWithFormsDesigner Da - moje svakodnevne stvari mogle bi biti kontrolni popis za mene, ali neće biti za nekoga drugog. Vjerojatno će im trebati pola stranice pozadinskih informacija kako bi protumačili što se događa.
@Rarity Postavite jedan. Instalirajte IIS na razvojni poslužitelj, zgrabite Windows Platform Installer i instalirajte ScrewTurn i samo pokrenite s njim. Više volim tražiti oproštaj nego dopuštenje. :)
@Brandon Preselio sam nas iz Apachea kako bismo nas odveli iz programa Windows Platform Installer! Pokušaj upotrebe PHP-a s te stvari bio je noćna mora ...
-1
#3
+3
voretaq7
2012-04-13 23:09:05 UTC
view on stackexchange narkive permalink

Rekao bih da biste trebali dokumentirati sve što radite. Ako je jedina dokumentacija kontrolni popis, onda da, treba ga nekako spremiti.

Ipak, napomena o terminologiji, ne govorim o "dokumentaciji" u smislu da se netko drugi na nju poziva kasnije, Govorim o zapisu vaših aktivnosti, prikladnom za spominjanje na vašem pregledu izvedbe. Vođenje popisa onoga što ste učinili pomoći će vam da sastavite izjavu o postignućima, a ako ste propustili važne ciljeve, dat će vam ideju o tome koji su se drugi zadaci pojavili zbog kojih su ciljevi / rokovi skliznuli.

#4
+2
FrustratedWithFormsDesigner
2012-04-13 21:21:46 UTC
view on stackexchange narkive permalink

Možda. Mislim da bi mjesto na kojem bi bili najkorisniji bilo osposobljavanje osoblja za nove zadatke koji su im nepoznati. Na primjer, rješavanje problema s određenom skupinom problema može uključivati ​​prolazak kroz neke korake i korištenje kontrolnog popisa za uklanjanje određenih situacija. Popis za provjeru mogao bi biti dobar i za zadatke kao što su složene implementacije koda ili promjene poslužitelja. Vidio sam jednostavne kontrolne popise u dokumentaciji za vodiče za postavljanje programera za postavljanje okruženja za složenije projekte.

Loša strana kontrolnog popisa je kada se osoba koja ga slijedi nesvjesno nalazi na instanci zadatka koji malo odstupa od onoga što kontrolni popis pretpostavlja. Nadam se da će se to dogoditi tek nakon što osoba postane dovoljno vješta da joj ne treba kontrolni popis i ne donosi vlastite odluke.

Također želite izbjeći da ljudi postanu u potpunosti ovisni o kontrolnom popisu, pa možda ne Neka to ne bude previše detaljno - možda ga napišite više kao smjernicu visoke razine, osim ako se određeni zadatak neće promijeniti i ako su neophodni detaljni detalji.

Nažalost, moji su kontrolni popisi više samo za mene, bilo bi potrebno znatno prepisivanje da bi bili korisni drugima. pogotovo kao nešto više od "onoga što sam nedavno radio"
@Rarity: Jesu li barem ponovljivi, tako da biste ih u budućnosti mogli ponovno koristiti kako biste izbjegli da sve morate ispočetka ispočetka?
Još ne, obično se ne dijele na pod-zadatke. Ako je nešto stvarno komplicirano, izložio sam to u stvarnom dokumentu, na primjer kako instalirati naš poslužitelj.
@Rarity: Korisno samo vama za zadatke koji se ne ponavljaju ... Na temelju načina na koji ih opisujete, mislim da biste mogli više koristiti podnošenjem popisa za kupovinu namirnica kao dokumentacije. Barem su oni * ponekad * ponovljivi. ;)
#5
+1
IDrinkandIKnowThings
2012-04-13 23:50:23 UTC
view on stackexchange narkive permalink

Trebali biste provjeriti politiku čuvanja dokumenata svojih tvrtki. Neke tvrtke mogu zahtijevati da ih zadržite, a neke ne. Razlog je taj što se nakon određenog vremena mogu smatrati dokumentima koji se mogu otkriti za pravne postupke. Oni se razlikuju ovisno o tvrtki. Radio sam u tvrtkama koje su smatrale da je bilo koji dokument tijekom 5 godina evidencija koja zahtijeva čuvanje. Čak i ako se radi o izborniku koji se koristi za iznošenje, a na njemu nije napisano.

Iz Wikipedije

Razdoblje čuvanja dokumenta je aspekt upravljanja zapisima. Predstavlja vremenski period u kojem se dokument treba čuvati ili "zadržati" u elektroničkom obliku i u papirnatom obliku. Po završetku razdoblja čuvanja, dokument se obično uništava. Izraz se općenito koriste kod računovođa i poreznih stručnjaka čije zanimanje uključuje bavljenje pravnim dokumentima koji trebaju postojati samo određeno vrijeme. Razdoblje čuvanja razlikuje se za različite vrste zapisa. Na primjer, dokumenti o poslovnom osnivanju imaju trajno razdoblje čuvanja (što znači da ih treba zadržati i nikada ne uništavati), ali primici za porezno priznate kupnje od strane pojedinog poreznog obveznika obično imaju trogodišnje razdoblje čuvanja (i često se mogu sigurno odbaciti nakon te točke.) Duljina razdoblja čuvanja razlikuje se ovisno o djelatnosti i temelji se na vjerojatnosti da će dokument biti potreban u nekom trenutku u budućnosti zbog ligitacije. Zapisi koji više neće imati svrhu (kako se određuje duljinom njihovog razdoblja čuvanja) uništavaju se zbog svemirskih problema, obično drobilicama papira.

#6
+1
Reinstate Monica - Goodbye SE
2012-04-14 16:48:30 UTC
view on stackexchange narkive permalink

Da biste prvo odgovorili na svoje posljednje pitanje, znat ćete jesu li zainteresirani drugi nakon što ga dokumentirate negdje gdje ga drugi mogu vidjeti.

Moj prijedlog: dokumentirajte ga na wikiju gdje ga svi mogu vidjeti. Možete ga staviti na stranicu kao "službeni" postupak za svoju poziciju ili na osobnu stranicu. Ali tada to mogu vidjeti barem drugi ljudi kad vas nema i preuzeti vaše zadatke. A ljudi na sličnim pozicijama u cijeloj tvrtki mogu je recenzirati i razmjenjivati ​​ideje.

Ključno je čuvanje javnosti i lako ažuriranje (i pristup, čak i putem vašeg iPada).

#7
  0
JohnFx
2012-04-13 23:38:37 UTC
view on stackexchange narkive permalink

Imate li sustav praćenja slučajeva kao što su Bugzilla ili FogBugz? Radim u programskom timu, a primjere FogBugz koristimo za opće zadatke, uz programske pogreške / zahtjeve, i to prilično dobro.

IT je mali sustav i praktički jedan tim za bilo koje popravak, tako da ne koristimo program za praćenje bugova, već samo urezujemo poruke. Nije bio dovoljan problem navesti nekoga drugog da koristi program za praćenje grešaka.
Zapravo možda tada imate sreće. FogBugz (i vjerojatno drugi) omogućit će vam da besplatno koristite hostiranu verziju njihovog alata ako imate manje od 2 korisnika (http://www.fogcreek.com/fogbugz/StudentAndStartup.html)


Ova pitanja su automatski prevedena s engleskog jezika.Izvorni sadržaj dostupan je na stackexchange-u, što zahvaljujemo na cc by-sa 3.0 licenci pod kojom se distribuira.
Loading...