forked from mi-classroom/webdev-fd-sose-2024-fd-2024-prufung-startercode-fd-2024-pruefung-startercode
-
Notifications
You must be signed in to change notification settings - Fork 0
/
notes-on-code.html
102 lines (82 loc) · 4.16 KB
/
notes-on-code.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
<!doctype html>
<html class="no-js" lang="de">
<head>
<meta charset="utf-8">
<!-- Page Info -->
<link rel="shortcut icon" href="/assets/img/favicon.ico">
<title>Abschlussarbeiten @cnoss // Professur für Kommunikationsdesign in der Medieninformatik</title>
<meta name="description" content="Ein bisschen Struktur und Prozess für Projekt- und Abschlussarbeiten unter meiner Betreuung.">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Bewertung von Code Repositories – Abschlussarbeiten @cnoss">
<meta name="twitter:description" content="Ein bisschen Struktur und Prozess für Projekt- und Abschlussarbeiten unter meiner Betreuung.">
<meta name="twitter:image:src" content="">
<!-- Facebook OpenGraph -->
<meta property="og:title" content="Bewertung von Code Repositories – Abschlussarbeiten @cnoss">
<meta property="og:description" content="Ein bisschen Struktur und Prozess für Projekt- und Abschlussarbeiten unter meiner Betreuung.">
<meta property="og:image" content="">
<!-- Styles -->
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="/assets/styles/_combined-styles.css">
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@48,400,0,0">
<!-- Highlight.js -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
<!-- and it's easy to individually load additional languages -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/go.min.js"></script>
<script src="/assets/js/main.js" type="module"></script>
</head>
<body class="simple">
<header class="header">
<div class="home-button"><a href="/"><i class="icofont-book-alt is-large"></i></a></div>
<h1 class="title">Praxisprojekte & Abschlussarbeiten</h1>
<h2 class="subtitle">bei <a href="https://christiannoss.de">Christian Noss</a></h2>
</header>
<main class="page ">
<section>
<h2>Bewertung von Code Repositories</h2>
<p>Bei der Bewertung von Projekten, die Code enthalten, schaue ich mir die unten aufgeführten Aspekte an. Diese Auflistung ist nicht abschließend, sondern dient als Anhaltspunkt.</p>
<h3 id="repo-und-kooperation">Repo und Kooperation</h3>
<ul>
<li>Repo enthält eine aussagekräftige ReadMe Datei.</li>
<li><a href="https://adr.github.io">ADRs</a> sind vorhanden, nachvollziehbar und fachlich angemessen</li>
<li>Commits haben sinnvolle Größe und Beschreibung</li>
<li>alle Projektteilnehmer haben Code beigesteuert</li>
<li>Nutzung von Issues zur Organisation</li>
<li>Nutzung eines sinnvollen Branching Konzepts</li>
<li>Pull Requests werden genutzt, sowie sinnvoll und verantwortungsvoll eingesetzt</li>
<li>ggf. Nutzung von Conventional Commits</li>
<li>ggf. Nutzung von Projects o.Ä.</li>
</ul>
<h3 id="code">Code</h3>
<ul>
<li>Technologie, Sprachen, Architektur sind fachlich angemessen ausgewählt und die Auswahl ist begründet</li>
<li>Code ist sinnvoll strukturiert und nachvollziehbar</li>
<li>Drittanbietercode wird explizit gemacht und der Einsatz begründet</li>
<li>Code ist lokal ausführbar</li>
<li>Anwendung ist deployed und jenseits von localhost erreichbar</li>
<li>sinnvoller Einsatz von Modulen/ Komponenten, Klassen und Funktionen</li>
<li>Nutzung sinnvoller Bezeichnungen für Module/ Komponenten, Klassen, Funktionen, Variablen, etc.</li>
<li>keine Magic Numbers/ Words/ Urls</li>
<li>Code ist schlank und aufgeräumt</li>
<li>Code ist robust</li>
<li>Implementierung ist angemessen (kein Over- oder Underengineering)</li>
</ul>
</section>
</main>
<footer class="footer">
<div>
<p id="kontakt">
Prof. Christian Noss<br>
Campus Gummersbach<br>
Steinmüllerallee 1<br>
51643 Gummersbach<br>
Raum 3.241<br>
<br>
<i class="icon">email</i>chr<!-- hehe@moeep -->istian<!-- hehe@moeep -->.noss<!-- hehe@moeep -->(at)t<!-- hehe@moeep -->h-koeln.de<br>
<i class="icon">phone</i>+49 2261-8196-6412
</p>
</div>
</footer>
</body>
</html>