-
Notifications
You must be signed in to change notification settings - Fork 17
Best practices ja mitä pitää tehdä ensi kerralla paremmin
kenkku edited this page Oct 1, 2012
·
7 revisions
- Aloittelijalle suunnattu versionhallintaopas, projektiin räätälöitynä
- Harjoituskierros versionhallinnan kanssa.
- Kaikille oma virtuaalikone tai muuten varmistus, että kaikki pystyvät kääntämään yhdessä tehdyn koodin.
- Eksoottisten fonttien kanssa tulee ongelmia eri koneilla.
- Vanhemmalle käyttöjärjestelmälle ei välttämättä löydy kaikkia ohjelmia.
- Valmis LaTeX-pohja ennen kuin aloitetaan (aikaa menee hukkaan, kun mietitään, millä saadaan esimerkit näyttämään kivalta jne.)
- Älä ikinä committaa/pushaa koodia, joka ei lateksoidu! Jos esimerkiksi 10 ihmisen työ seisoo kuusi minuuttia kun kenenkään koodi ei käänny, menee hukkaan yksi henkilötyötunti!
- Ei ääkkösiä tiedostonnimiin (menee solmuun, kun käytössä eri käyttöjärjestelmiä, tässä erityisesti ongelmana OS X, joka koodaa ääkköset kahtena merkkinä).
- Pyryn (kokenut Git-käyttäjä) idea: muutoksista oma branchi, ja osaava tyyppi joka yhdistää niitä pääversioon. -> ei konflikteja
- Selkeästi kirjoitettu esimerkki mahdollisesta työnkulusta jota voisi soveltaa myös oppikirja-projektiin.
- Kaikille ei välttämättä tarvitse opettaa versionhallinnan käyttöä. Jos joku tulee vain iltapäiväksi paikalle tai tekee esim. lähinnä pelkkiä tehtäviä, voi joku muu tuoda muutokset versionhallintaan.
- Jos yksi ihminen kirjoittaa kirjan 200 tunnissa, 20 henkilöä ei kirjoita sitä 10 tunnissa (hallinto ja säätäminen kasvaa samalla kun väkimäärä kasvaa).