Pracowałem w sklepach, które produkują oprogramowanie krytyczne dla życia i zajmowałem się regułami komentowania, które miały na celu utrzymanie czytelności kodu i potencjalne uratowanie życia. Z mojego doświadczenia wynika jednak, że wymóg ten staje się umysłem, od którego należy usunąć listę...
Widziałem tę część PEP-8 https://www.python.org/dev/peps/pep-0008/#package-and-module-names Nie jestem pewien, czy odnosi się to do nazwy pliku modułu / klasy / pakietu. Gdybym miał jeden przykład każdego z nich, czy nazwy plików powinny być pisane małymi literami, jeśli to właściwe? Albo coś...
Rozdział wuja Boba na temat nazw w Czystym Kodzie zaleca unikanie kodowania nazw, głównie w odniesieniu do notacji węgierskiej. On także wyraźnie wymienia usunięcie Iprefiksu z interfejsów, ale nie pokazują przykłady. Załóżmy, że: Wykorzystanie interfejsu służy głównie do testowania poprzez...
Pochodząc głównie z języka c #, przyzwyczaiłem się używać terminu „interfejs” do opisywania obiektu bez implementacji, która określa zachowanie. W języku c # konwencja polega na dodawaniu nazw interfejsów do „I”, jak w IEnumerableitd. Oczywiście koncepcja ma różne nazwy w różnych językach. W Swift...
Jaka jest lepsza nazwa metody zwracającej wartość
Właśnie rozwidliłem projekt w Github, wprowadziłem zmiany itp. To mnie zastanowiło: w projektach typu open source widzę głównie README.txt, a edytowany przeze mnie plik to Readme.txt. Czy to jest jakaś standaryzacja, czy powinienem ją zostawić taką, jaka
Jeśli istnieje metoda bool DoStuff() { try { // doing stuff... return true; } catch (SomeSpecificException ex) { return false; } } czy raczej powinno się to nazywać IsStuffDone()? Obie nazwy mogą zostać błędnie zinterpretowane przez użytkownika: Jeśli nazwa jest DoStuff()przyczyną, dla...
Jeśli oprogramowanie / biblioteka ma pewne wsparcie dla platformy Windows, prawie zawsze nazywają swoje katalogi i zmienne jako win32. Jest to najbardziej rozpowszechnione w projektach C / C ++. Nawet trzykrotne wykorzystanie docelowego projektu MinGWwin32 . Czy jest tego powód? Dlaczego nie użyć...
Ostatnio pracuję z obiektem XMLHttpRequest w JavaScript i nie mogłem nie zauważyć, że obudowa tej nazwy nie ma sensu. Dlaczego „XML” jest pisany wielkimi literami, a „HTTP” nie? Oba są akronimami! Z pewnością bardziej sensowne byłoby, aby nazwa była jedną z następujących: XmlHttpRequest...
Jest to dość ugruntowana konwencja, że nazwy tabel bazy danych, przynajmniej w SQL, powinny być pojedyncze. SELECT * FROM user;Zobacz to pytanie i dyskusję . Jest to również dość popularna konwencja, że nazwy zasobów interfejsu API RESTful powinny być w liczbie mnogiej. GET /users/123i POST...
To pytanie zostało przeniesione z przepełnienia stosu, ponieważ można na nie odpowiedzieć w programie Software Engineering Stack Exchange. Migrował 8 lat temu . Właśnie zaczynam się uczyć języka C #. Pochodząc z tła w Javie, C ++ i Objective-C, uważam, że pascal C # w...
Po przeczytaniu odpowiedzi gnat jest do Dlaczego statyczną metodą Głównym w Java i C #, a nie konstruktor? Uważam, że jego odpowiedź oznacza, że celem klasy Java ze statyczną metodą główną jest to, define a program entry pointże nie jest to sam program. Może być lepszy sposób, aby to zrobić, ale...
Java SE 8 jest wyposażony w nowy mechanizm dat wprowadzenia LocalDate, LocalTimei LocalDateTimeklas do reprezentowania chwilach czasu. Manipulować takie momenty, zestaw metod podano: LocalDate.plusDays(...), LocalDate.minusDays(...)i tak dalej. Zawsze myślałem, że dobrą praktyką było nazywanie...
Jaka jest historia konwencji nazywania wielkimi literami? Moją intuicją jest to, że zaczęło się od preprocesora C, gdzie ludzie opracowali praktykę nazywania makr preprocesora wielkimi literami, aby skutecznie żyć w osobnej przestrzeni nazw i unikać kolizji nazw. Wierzę, że ta praktyka została...
Zamknięte . To pytanie jest oparte na opiniach . Obecnie nie przyjmuje odpowiedzi. Chcesz poprawić to pytanie? Zaktualizuj pytanie, aby można było na nie odpowiedzieć faktami i cytatami, edytując ten post . Zamknięte 4 lata temu . Kiedy używasz zmiennych,...
Pracuję w projekcie, który dotyczy urządzeń fizycznych i byłem zdezorientowany, jak prawidłowo nazwać niektóre klasy w tym projekcie. Biorąc pod uwagę fakt, że rzeczywiste urządzenia (czujniki i odbiorniki) to jedno, a ich reprezentacja w oprogramowaniu jest inna, myślę o nadaniu nazw niektórym...
Dużo krytykuję ze strony innych programistów ze względu na to, że wykorzystuję pełną odpowiednią obudowę dla wszystkich moich zmiennych. Na przykład typowy programista użyje employeeCountnazwy zmiennej, ale ja jej używam EmployeeCount. Używam pełnej właściwej obudowy do wszystkiego , czy to metoda...
W dawnych czasach robiliśmy zapis węgierski. To jest teraz uważane za passé i przez większość czasu już go nie używam, ale nadal znajduję zastosowanie m_prefiksu do wskazania pól członków. Dla mnie, jeśli czytam czyjś kod i widzę to: count = 3; Zakładam, że countjest to zmienna lokalna dla tej...
Załóżmy, że mam formularz w mojej aplikacji internetowej, w którym użytkownicy mogą przesyłać zdjęcie profilowe. Mam kilka wymagań dotyczących rozmiaru pliku, wymiarów itp., Ale kiedy użytkownik przesyła obraz, jak mam je nazwać w moim systemie? Przypuszczam, że musiałby być spójny, a także...
Mój projekt ma obecnie problemy z nazewnictwem środowiska. Różni ludzie mają różne założenia co do tego, jakie środowiska należy nazwać lub co oznaczają nazwy, co powoduje zamieszanie podczas ich omawiania. Przeprowadziłem trochę badań i nie znalazłem tam żadnych standardów. Określenia obejmują...