Patronum kodumuz hakkında açıklamalı bir İngilizce anlatım istiyor.

Patronumun okumak ve takip edebilmek istediği bir açıklama veya yorum yapmam istendi.

Programcı olmadığı için kodu takip edemiyor, bu yüzden hepsinin İngilizce'ye çevrilmesini istiyor.

Bunu daha önce yapması istenen oldu mu?

Tüm kaynak kodları hakkında yorum yaptım ve JSDoc'u tüm işlevlerin, değişkenlerin vb.

Programcı olmayanların kodunu yorumlamak için yapabileceğim başka bir şey var mı?

Bu makul bir istek değil mi?

GÜNCELLEME

Sonunda, neden istediğini yapmak için neden iyi bir zaman kullanmadığını açıklamayı başardım. O makul bir adam ve işimin ne işe yaradığını tam olarak anlamadı. Bu yazıyı görünce, normal bir istek olmadığını hemen anladı.

Başka bir programcının izlemesi için uygun belgeler sağladım (JSDoc ve satır içi yorumlar - ayrıca teknik konular hakkında bazı ek notlar) ve patronumun izleyeceği programın ana mantığının çok geniş bir akış şeması diyagramı.

Sonunda, tüm taraflar memnun kaldı ve biz devam ettik.

Hayır , makul bir istek değil!

Her halükarda BT HIM OUT KONUŞ ya da bir başkası onu konuştum. Bu, mantıklı bir fikir, ki yapılması mümkün olsa da, yapılması gereken kadar pahalı olmamıştı. İşlevlere ve alt programlara genel bir bakış makul, ancak her kod satırını "açıklamak" değildir. Dili okumayı öğrenmek onun için yapmaktan daha etkili olurdu.

İstediği bir sonraki şey matematiksel formülleri ya da İngilizce metne çevirmemek. Kesinlikle mümkün olsa da, bu hata ve yanlış yorumlama için çok yer sağlar ve asla yapılmamalıdır. Tıpkı İngilizceye "çeviri" kodu gibi.

Eğer var mı tasarım belgelerini ? Bunlar, kodun ne yaptığının İngilizce açıklaması. Programlamayan bir yöneticinin bundan daha fazlasına ihtiyacı olmamalıdır.

Yılın bir mikro yöneticisi var mı? Patronun aday olmayı hak ediyor gibiydi. Kod satır satır seviye anlayışı gerektiğine inanan, ancak doğrudan okumayı öğrenmek istemeyen biri, hayal edilebileceği kadar mikro-yönetici kadar mükemmeldir.

Bir geliştirici olmanın bir avantajı, kod anlama zorluğunun, belirli bir derecenin ötesinde, en azından ayrıntılı uygulama düzeyinde, en azından teknik olmayan bir yönetim tarafından mikro yönetimi önlediğidir; çünkü en sert çekirdek yönetici bile Bu düzeyde başlarının üstünde. Ancak patronunuzun dehası silikon perdeyi kırmanın bir yolunu bulabilir.

Ve bir bonus olarak, çeşitli iyileştirmeler önermek için İngilizce çeviriyi kullanmadan önce bile, çeviriyi yaparken muazzam miktarda geliştirici zamanını boşa harcıyor (programcılardan daha iyi kodlamayı bildiğini sanıyorum, yapamamasına rağmen) Kodu okuyunuz ve birisini çevirir çevirmez bilgeliğini paylaşabileceksiniz, aksi halde neden çevrilen her çizgiye ihtiyaç duyuyor?).

Yani, hayır, bu makul bir istek değil ve daha önce hiç duymamıştım. Ve senin için hissediyorum. Herkesin sessizce başka bir iş aramaya başlaması gerekebileceğini düşünüyorum, çünkü kod çevirisini yönetim aracı olarak kullanmaya başladığında, muhtemelen çalışmak için vahşi bir yer olacak (çalışmak için daha vahşi bir yer).

Artı tarafta, belki de durumundan sonra adlandırılmış yeni bir anti-patern bulabilirsin? “Kirli Macarca Phrasebook” anti-paterni, bir tobacconistin İngilizce yanlış konuşmayan bir Macarca cümle kitabı kullanarak İngilizce konuşamayan biriyle iletişim kurmaya çalıştığı Monty Python skeçinden sonra ne olur?

Yanına otur ve kodun 10 satırı boyunca onunla konuş. İkiniz de istediği ölçüde anlayacağına karar verene kadar her ayrıntıyı açıklayın.

Belki de aradığı şey budur: işinizin size neye benzediği ve yazılımın sizin bakış açınızdan nasıl göründüğü hakkında bir izlenim. Bu benim kitabımda iyi bir şey.

Eğer bundan sonra, hala devam etmeni istiyorsa, şunu söyleyin: Ne kadar soru sormam gerektiğine dikkat edin; Bunları soru sorabilmeksizin açıklamak zorunda olsaydım, neyin dahil edip neyin dışarıda bırakılacağını nasıl bilebilirdim? Sonuçların sizin için yararlı olması için ne kadar zaman alacaktı? Şimdi, bu şekilde ne yapmamı istiyorsunuz?

Bunun makul bir istek olduğunu sanmıyorum. KAYNAK KODU İngilizce (veya bu konuda başka herhangi bir dilde) okunması anlamına gelmez.

Belki de kodunu onaylamadığı ya da farkında olmadığı bir şeyi yapmasından korkuyordur. Durum buysa, yapabileceğiniz bir şey olduğunu sanmıyorum. Dokümanları yazmanız veya belki de kodunuzu denetlemesi için birisini işe almaya ikna etmeniz gerekecektir.

Gerçekten çok basit:

• Programcı olarak becerileriniz nedeniyle işe alındınız
• Yöneticiniz bu becerilere sahip değil
• Ergo, menajerinin ne yaptığını tam olarak anlayabilmesi için makul bir beklentide olmaması gerekiyor

Daha önceki bir işte buna benzer bir deneyim yaşadım. Yöneticim bir muhasebeciydi (ve bu nedenle oldukça düşük seviyede ayrıntı odaklı) ve programlamayı anlamadı veya gerçekten güvenmedi. Teknik olmayan bir kişi olarak, yazdıklarımın önemsizliğini kavrayamayacağını düşünmemesi gerektiğini anlayamadı. Aşırı belgelendirme ve teknik olmayan kullanıcıları kodun nasıl yönetileceği ve değiştirileceği konusunda (evet, gerçekten) yetiştirme taleplerinin ardından, onu silmeyi bırakmayı denedim ve düpedüz reddettim. Açıkladığım analoji basitti:

• Ben muhasebeci değilim
• Hesaplarımızdaki her bir işlemi veya kayıt işlemini anlamayı beklememeliyim
• Bu, hesapların yanlış veya güvenilmez olduğu anlamına gelmez, çünkü onları anlamıyorum.
• Bu, onları derleyen kişiye güvenerek mümkün olur

Her şeyden önce, bunun bana geldiği şey buydu: çalışanlarına güvenmekte zorluk çeken bir yönetici; veya bırakacaklarından korkuyorlar ve bunun buna karşı hafifletmenin etkili bir yolu olduğunu düşünüyor.

Bunun tek çözümü oturup neden bunun anlam ifade etmediğini açıklamak. Kodunuzu anlamak ve benzer bir beceriye sahip birisinin sizin yöneticinize değil , sizin anlayabilmeniz için kodunu anlamak sizin işinizdir. Onlara bu konuyu göstermek iyi bir fikir olabilir (veya kişiliğine bağlı olarak gerçekten, gerçekten korkunç bir fikir).

Satır-satır, saçma. Önerebilirim yorumlardan dokümanlar oluşturmak ve ona bunu sunmak. Geçmişte üzerinde çalıştığım bir dizi Kanada Hükümeti hibesi ve denetimi için bu yeterliydi.

Satır satır almayacak ama yine de gereğinden fazla ayrıntıda olması gereken metot metot alacak.

Platformunuza bağlı olarak mevcut bazı çözümler:

• C #: sandcastle
• Java: javadoc
• "C ++, C, Java, Amaç-C, Python, IDL (Corba ve Microsoft lezzetleri), Fortran, VHDL, PHP, C # ve bir dereceye kadar D." : doxygen

Kodu okumayı öğrenmesi, ilginç bir uygulamanın tüm kodunu İngilizce'ye çevirmekten daha hızlı olacaktır. Ayrıca bunu COBOL ile denedik ve hiç yardımı olmadı. Eğer öğrenmeye istekli değilse, ama sadece cehaletini başkasının problemine dönüştürmek istiyorsa, ciddi derecede sivri kafalı bir patronun var.

Patronunu takip etmek için teknik uzmanlığını kullan.

1. Bunu ilk etapta kodlamanız için yaptığınız kadar uzun süreceğini bilsin (Daha uzun süre yapmaktan çekinmeyin).
2. Ona bu belgenin ne kadar güncel olması gerektiğini sor. Ona tüm kodlama değişikliklerinin şimdi en az iki kat daha uzun süreceğini haber ver.
3. Siz veya bir başkası herhangi bir hata bulursa, şimdi düzeltmeniz veya psuedo kodlaması tamamlanana kadar beklemeniz gerekip gerekmediğini sorun. Ona 1 ve 2'yi hatırlat.

Tüm kötü çözüm önerileri gibi, sorunu tanımlamak daha iyidir. Belki patronun üst yönetim tarafından teknik sorulara kapılıyor ve cevaplayamadığı için kendinden utanıyor. En çok endişe duyduğu belirli bir kod bölümü olabilir, bu yüzden bu büyük girişimi yalnızca o bölgeyle sınırlayabilirsiniz.

Bir örnek göndererek, kodlamanın nasıl çalıştığını anlamadıysanız (bir döngü nedir ve tüm bu öğelere ne yapıyor?) Ne anlama geldiğini anlamadığı sonucuna varabilir. Uygulamayı güçlü bir kullanıcı perspektifinden anlamak. Bence, ona gerçek kod / ipucu yazmayı tercih edeceğinizi bildirmeniz adil olur - Başka bir iş arıyorum.

Neden?

Bir satır satır yorum makul değil, ancak işte size soracağım: neden bunu istiyorsun?

Öyle mi ...

• Yazılımın ne yaptığını tam olarak anlamak ister misiniz (mutlaka nasıl yapılır)?
• Ayrılırsam başka bir programcının projeyi alabileceğinden emin olmak ister misin?
• Gerçek iş yaptığımı görmek ister misin?

Bu isteğin arkasında makul bir arzu olabilir ve bunu anlayarak ve bu ihtiyacı karşılayarak patronunuzu mutlu edebilirsiniz.

Güncelleme

Yorumlara dayanarak Mikey's, belki de bunu biraz fazla açık ifade ettim. Demek istediğim kelimenin tam anlamıyla "neden bunu istiyorsun?" Demelisin, sadece bunu bulmalısın . İfade ve ses tonu büyük bir fark yaratıyor. Özellikle, şöyle bir şey söyleyebilirsin:

“Her bir kod satırının açıklamasını isteğiniz hakkında düşündüm. Bu şekilde yapılması biraz alışılmadık bir durum. Merak ediyorum, işim hakkında sizinle iyi iletişim kurmadığım bir şey olup olmadığını merak ediyordum. Kodumuzu veya ne yaptığımı gerçekten anlamak istediğiniz şey nedir? Burada ne yapmaya çalışıyorsunuz? ”

Tabii ki, bu kadar mümkün patronun tamamen mantıksız olduğunu. Ancak, bu isteğin ne kadar tuhaf olduğunu bilmemesi ve akılda rasyonel bir amacı olması daha muhtemeldir.

Değilse, özgeçmişinizi parlatmaya başlayın. :)

Okuryazar programlamayı denemek için iyi bir şansa benziyor. Google'a sor. :)

Ama ... bu tamamen mantıksız bir istek değil. İşinizin bir kısmı (en önemli kısım, imo), algoritmalarınızı diğer geliştiricilere ve gerekirse teknik olmayan kişilere iletmektir. Bence iletişim kuramayan yalnız dahi programcılar her zaman problemlidir, sanırım.

Bu amaçla, kodunuzun çok açık olması gerekir (yani: gerçekten kendi kendini belgeleyen veya iyi belgelenmiş ve "kendi kendini belgeleyen" derken, değişkenlerin ve işlevlerin bir anlamı veya sorumluluğu vardır ve isimleri bunu açıkça yansıtır). Patronunun isteği için iyi sebepleri olabilir. Belki (sadece burada tahmin ediyorum) siz veya selefinizin geçilmez, kırılgan kodları hakkında bir ününüz var ve bu patronunuzun çözümü. Bu biraz aşırı, ama sizin için yararlı bir egzersiz olabilir. Daha iyi dokümanlar yazmanın zaman aldığını bildiğini varsayıyorum (ve eğer yapmazsa, eğitilmeli - tıpkı bir dönem ödevi yazmak gibi: yazmaktan daha uzun sürer).

Satır satır çevirme bile her kod satırının anlamını etkili bir şekilde iletmeyecektir. Bir programcının bir kod satırını anlaması her zaman birçok faktörün bağlamındadır. Çok iş parçacıklı kodun bir parçası gibi bir şey içine alın ve ingilizce çeviri ham koddan daha anlamlı gelmez. Birden fazla işlev / dosya arasında dağılmış olan işlevselliği düşünün. Bazı kodlar, kapsamlı miktarda başka kodlar açıklamadan kesinlikle bir anlam ifade etmez. Bağımlılık enjeksiyonunda "satır satır" olarak yer alan farklı parçaları açıklamaya çalışın ve ne demek istediğimi göreceksiniz. Hemen hemen her şeyin Tanrı işlev prosedürünün ötesine geçmesi, İngilizce çeviriyi anlamak için kapsamlı bir programlama bilgisi gerektirecektir. Ayrıca, if / else karar ifadesi kadar basit olan bir şeye bakın. Satır satır yok. çünkü bir sonraki satır çalışma zamanı verilerine bağlı. Bir sonraki satır, birkaç olasılıktan biri olabilir.Başvurunuzun ne yaptığını açıkladığınızda, PM'nizi bir programcı haline getirmiş olacaksınız ve her ikisi de 5 yaş daha büyük olacak.

Programlamayı öğrettiğim için, devam etmekten çok mutlu olurdum.

Hızla o ben çünkü beni üzüyorsun, hangi için o umduğundan fazlasını gidiyor göreceksiniz sever şeyleri açıklayan :-)

Patronunuza atıfta bulunduğunuzda bu “sizden / ekibinizden sorumlu bir orta yönetici” mi? veya Şirketinizin Sahibi? "Saate göre" veya "maaş üzerinden" mi ödeniyorsunuz?

Patronunuz sorumlu bir orta düzey yönetici ise, HIS BOSS'U KONUŞMAK, patronunuzun ihtiyacını karşılamak için şirkete olan verimliliğinizin ne olabileceğinin 1 / 3'üne indirileceğini belirtmektedir.

Patronunuz "çekleri imzalayan adam" ise ona aynı şeyi, daha diplomatik olarak açıklayın. İşiniz "Kodu yazın" - "Kodu yazın, kodun açıklamasını yazın, açıklamayı açıklayın."

Bir akış şeması muhtemelen onun için daha faydalı olacaktır. Bu kesinlikle alışılmadık bir istektir ve yönetici olarak onun hakkında fazla bir şey söylemez.

Patronunuzun yazdığınız kodu anlamak için biraz zaman harcamak istemesi, sizin yararınız için kullanabilirsiniz. Onu Salatalık ile tanıştırmayı deneyin: http://cukes.info/

ve patronunuzun gelecekte sizin için BDD testi yazmasını sağlayın.

Bunların hiçbirini bilmek için canını sıkmamalı. Ona, yazılım geliştirme uygulamalarının değişime tabi olduğunu söyleyin. Etkinlik tasarımı değişebilir. Ona bilgiyi gizleme, kapsama ve soyutlama hakkında bilgi verin.
Ekibinizin bir parçası olarak, kodunuzun müşterisi olarak, daha geniş anlamda, yalnızca kodunuzun yaptığı şeyin net ve yüksek bir soyutlamasıyla çalışmalıdır. Kodunuzun herhangi bir katmanı, başka birinin kodunun başka bir katmanı ile aynı şekilde çalışır. Bundan daha fazlasını bilmek, onu sadece yavaşlatır ve kodunuzun içsel çalışmalarına dayanarak varsayımlarda bulunma riskini taşır. Bu varsayımlar, kodunuzu değiştirmeniz gerektiğinde, bunlara dayanarak herhangi bir sistem veya süreç oluşturması halinde, sorun haline gelmeye devam etmeyi bırakacaktır.
Ayrıca bu tür işleri yapmak zorunda olmanız veriminizi düşürür. Sadece iki farklı yerde daha sonra değişiklik yapmanız gerekmeyecek, aynı zamanda iş moralinizi de olumsuz yönde etkileyecek ve bu da çıktınızı daha da azaltacaktır.

İngilizcenin güzelliği, bunun güzelliği engellemesidir. Bunu kendi yararınıza kullanırsanız, bir daha asla bu tür bir taleple başa çıkmayacaksınız. Kodun küçük bir kısmını örnek olarak alırdım, ancak çok soyutlanan ve anlaşılması kolay olmayan bir örnek. Daha sonra teknik İngilizce dilinde bir programlama kitabındaki bir bölüm için yazıyormuşsunuz gibi yazacağım. Takip etmek ne kadar uzun ve karmaşık olursa, o kadar iyidir. Bu özelliği belgelendirmenin kaç saat sürdüğünü ona söyle. Ardından, gerçek kod tabanının sadece% 1 / 10'unun (kod satırlarını temel alarak gerçek rakamları kullanın, eğer muhtemelen bundan daha kötüsü) kullanın. İngilizce çevirisinin ne söylediğine dair hiçbir fikri olmadığını ve bu seviyedeki dokümantasyonun 20.000 adam-saat alacağını fark ettiğinde oldukça çabuk geri çekilir. Ancak görevini yerine getirmek için çok ciddiyetle çalışın. Yapma, bunu çıkaramazsan ve onunla oynadığından şüpheleniyorsa, bunu dene.

Bu özel bir tatil sorunu sivri saçlı patronu Dilbert şeridi için aday gibi görünüyor ! Söz konusu talep, kesinlikle değil ses ilk bakışta makul.

Mizah bir yana, gerçekte neye ihtiyaç duyduğunu ve nedenini bulmaya çalışın , daha sonra ona para vermesi için ona dolar veya saat cinsinden ne kadar mal olacağı konusunda tavsiyede bulunun ve bu kadar para harcamak isteyip istemediğine karar vermesine izin verin.

Kendinize gelince, görünüşte tuhaf isteğini yerine getirmeniz için harcayacağınız saatleri sayın ve daha sonra size zaman vermek isteyen bir işveren için çalışan yeni bir iş bulmak için bu kadar zamanın bir kısmına yatırım yapmanın daha iyi olmayacağını belirleyin. profesyonel olarak!

Onu ofisine getir ve kodunu bir tur at.

Saçma bir talepte bulunmasının bir yolunu fark edecek ve uzaklaşıp sizi bir daha asla rahatsız etmeyecek.

Eğer kodunuzu anlamaya çalışmasına yardım etme taleplerini yerine getirmezseniz, size sormak için farklı ama aynı derecede saçma yollar bulacaktır.

Bu, temyizin aşınmadan daha iyi çalıştığı bir durum.

Bunu yapan "X Dilini İngilizceye" tercümanımız olsaydı çok iyi olurdu. Sonra biri sırıtıp, sorun yok diyebilirsin, patron, bir dakika içinde buna sahip olacaksın. Ve sonra okuyan bazı megabayt metnin bulunduğu bir posta geliyor:

• 20 elementli yeni bir tamsayı dizisi olsun.
• X tamsayıları saklamak için bir değişken olsun.
• X'i 0'a ayarlayın
• X 20'den küçükken, sonraki 2 satırda belirtilenleri yapın
• a dizgesini x dizini ile, x + 1 argümanıyla nThPrime çağırmanın sonucuna ayarlayın
• x'i 1 arttır
• ....

Başka bir seçenek de bundan sonra Shakespeare'de programlama önermek olacaktır .

Patronum kodumuz hakkında açıklamalı bir İngilizce anlatım istiyor.

Zorlu.

Programcı olmadığı için kodu takip edemiyor, bu yüzden hepsinin İngilizce'ye çevrilmesini istiyor.

Programcı değilse , kodu okumamalıdır. Hiç.

Bunun yerine üst düzey belgeler sağlayın.

Bu makul bir istek değil mi?

Hayır.

Bir programcı olarak, gerçekten "iki" işiniz var.

Birincisi iyi programlar yaratmak. İkincisi, onları şirket içindeki ve dışındaki müşterilere "satmaktır".

Patronunun isteği, ilk işini "incitiyor". Programlarınızı belgelemek daha fazla zaman alır. Öte yandan, aslında "ikinci" işinizde daha çok çalışmanızı sağlıyor.

Patronunuz sizden programınızı İngilizce olarak HIS yardımı için ve muhtemelen şirket içinde, dışında ve dışında ilgilenmesi gereken kişilerin yararına belgelendirmesini istiyor. Eğer işini yapmasına yardım edersen, daha fazla donanım, personel veya para kazanmalarını istediğinde, uzun vadede yararına çalışmalı. Ne de olsa, senden daha fazla iş yapmanı istedi.

BDD'nin bu soruna çok yakışacağını düşünüyorum , projeniz bitmek üzere olsa da, şimdi uygulamak çok zor, bu yüzden gelecekteki referanslar için daha fazla.

BDD ile kullanım durumları, daha sonra otomatikleştirilmiş işlevsel testlere çevrilen, insan tarafından okunabilen belgeler olarak tanımlanmaktadır.

Muhtemelen, bu istek ANTLR gibi şeyleri öğrenmek için iyi bir zamandır . ANTLR'yi alın, dilinizin gramerini alın, sahip olduğunuz tüm kodları ayrıştırın, her düğüm için AST oluşturucu şablon tabanlı açıklamaları geçin i++, şöyle tanımlanır increase i by 1 using postfix increment operator. Bu gerçekten komik olmalı. Patronunuz bu aracın build komut dosyasına dahil edilmesini de isteyebilir, bu nedenle herhangi bir değişiklik yaptığınızda, yeni sürümün ne yaptığını açıklayan bir ~ 20 MB e-posta alır.

PS Sadece şaka, o bir aptal.

Bunun makul olmayan bir istek olduğu konusunda hemfikir olmama rağmen , patronunuz , kodunuzu ve satır satır veya yan tümce yorumlarınızı iki sütunlu HTML çıktısına ayıran Docco'nun çıktısı gibi bir şeyi takdir edebilir . diğer tarafta yan ve nesir. Elbette yorumları kendiniz yazmak zorundasınız, ancak sunum teknik olmayan okuyucular için bile güzel bir IMHO. Örneğin, Underscore.js için açıklamalı kodun satır satır yorumlanan bölümüne bakın . Python ve shell script versiyonları da var.

Patronun bilgisiz ve korkutucu olabilir, ama aslında makul bir insan olabilir. Öyleyse, onunla birlikte akıl yürütmek işe yarayabilir - “gerçekten ne istediğini” sağlamaya söz verdiğiniz geçici bir konuşma, yani; programın ne yaptığını bir nesir kılavuzu.

"Yoluma ya da karayoluna" gelirse, şimdi gazınızı kontrol edin.

Aşağıdaki gibi bir davranış odaklı tasarım çerçevesini kullanarak bazı kabul testlerini yazabilirsiniz salatalık ? Bu kodu açıklamayacak; ne yaptığını ve doğal dilde açıklayacaktır. Ayrıca çalıştırılabilir olma avantajı da vardır, bu nedenle belgelerin güncel olduğundan her zaman emin olabilirsiniz, çünkü değilse, test çalıştırıcısı kırmızı olacaktır.

Giriş videosunu izleyin. Belki yeni bir patron bulurken iyi bir saptırma ... ;-)

Yöneticiniz, insanların yönettiğini ne yaptığını anlamadığı ve ürettikleri sonuçları anlama geçmişine sahip olmadığı gerçeğinden neredeyse kesinlikle rahatsızlık duyuyor.

Bu çözümü çok iyice düşündüğünden şüpheliyim ve muhtemelen ilk bakışta ona karşı duyarlı görünüyordu. Ancak bu büyük ölçüde çünkü programlama kodunun gerçekte ne olduğunu anlamıyor.

Herhangi bir programcı bu isteğin saçmalığını anlar, ancak şunu yaparız, çünkü dili geçtikten sonra, ortaya çıkan tek şey, aynı derecede şifreli olan algoritma olduğunu sezgisel olarak biliyoruz.

// Set s to the first address in the server list
server_info *s = cmd->servers;
// Loop until s is NULL
while (s) {
    // call the server's init function passing our current ID and address
    s->init(proc->id,*addr);
    // call log::info with our custom message
    log::info("Starting server %s",s->name);
    // Set s to the value returned by the server's next() function
    s=s->next();
} // end of loop

Buradaki sorun, yorumlar, her satırın ne yaptığını açıklarken, tüm sonuçların ne olduğunu anlamadığınız sürece, kodun gerçekte ne yaptığı hakkında hiçbir fikriniz yoktur. Bir programcıysanız ve bu modeli daha önce görmüşseniz açıktır; ancak bunu yalnızca satışları anlayan birine gösterin ve yorumları olduğu gibi okuduktan sonra kafası karışacak.

Patronunuza temel bir programlama öğreterek zaman kazanabilirsiniz . Eğer kodunu okumak istiyorsa, ona yapabilmesi için ona araçları ver. Çoğu dil oldukça kompakt bir sözdizimindedir ve yapıyı öğrenmek sadece bir ya da iki saat sürer. Neredeyse kesinlikle birkaç gün sonra pes edecek, ama en azından ne geçtiğini ve daha önemlisi neden kodunuzu okumak istemediğini bilecek .

IMHO ... Görevin yerine getirilmesinden sorumluysa, nasıl çalıştığını bilmeli ... :)