2024-what-makes-code-good

[carinaschrenk]

Article of Round 2

[carinaschrenk]

Internal Feedback Round 2A 21.11

Thoughts

• The second paragraph is good
• Fluffy introduction -> could be more to the core
• Good information to know

Ideas

• The first paragraph could be sharper
  • -> code is not only written for machines but for humans -> revisability

[belle903]

External feedback:

Part of participants that are computer science students/graduates: 45 %
Part of participants that would read the booklet if it was not for this survey: 67 %

Clarity of the article:

• Very clear: 39 %
• Clear: 28 %
• Not clear: 33 %

Technical vs. Non-technical:

• Good balance between technical depth and readability: 61 %
• The article was too technical: 39 %

Engagement:

• I stayed engaged throughout: 56 %
• I lost interest midway: 44 %

Structure of the article:

• The structure is clear and easy to follow: 61 %
• The structure was confusing: 39 %

Part of participants that understand the purpose of the article: 72 %

Part of participants that think the drawing helps to understand the meaning of the article: 56 %

Factual errors/inaccuracies or additional comments: -

[ParthS007]

What is good code?

Code is more than just instructions for machines; it’s a shared language for humans. Good code allows collaboration by ensuring that every person who interacts with it—the original author, a colleague, or even someone years later—can understand and contribute effectively.

Good code is clear, well-documented and embraces consistency.

Good code is not just a technical artefact; it’s a conversation. It bridges gaps, aligns efforts, and empowers teams to build software efficiently and joyfully.

[cloudflare-workers-and-pages]

Deploying tilics with    Cloudflare Pages

Latest commit:	fcc1c82
Status:	🚫  Build failed.

View logs