Skip to content

Commit

Permalink
revisions
Browse files Browse the repository at this point in the history
  • Loading branch information
geritwagner committed Feb 6, 2025
1 parent 772fd44 commit 640e9e4
Show file tree
Hide file tree
Showing 9 changed files with 76 additions and 42 deletions.
22 changes: 0 additions & 22 deletions docs/pre_submission.md

This file was deleted.

File renamed without changes.
6 changes: 6 additions & 0 deletions docs/writing/feedback.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ parent: "Writing Guide"
nav_order: 4
---

<style>
p {
text-align: justify;
}
</style>

# Feedback

We offer regular **feedback sessions** (every one to two weeks) to discuss open questions and the next steps:
Expand Down
23 changes: 21 additions & 2 deletions docs/writing/polishing.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,17 @@
---
layout: default
title: "Structure and Contents"
title: "Polishing phase"
has_toc: true
parent: "Writing Guide"
nav_order: 4
---

<style>
p {
text-align: justify;
}
</style>

# Polishing Phase


Expand All @@ -18,7 +24,20 @@ nav_order: 4
> - Evaluation Criteria

Before submitting your thesis, we encourage students to consult the [pre-submission checklist](docs/pre_submission.html).
Before submitting your thesis, we encourage students to go through the pre-submission checklist:

- For (regression) models, the model formulas are provided.
- Every figure and table is referenced and described in the text.
- Choose appropriate formatting of numbers that does not suggest unjustified levels of accuracy (e.g., response times of employees in ms).
- If feasible, arrange rows/columns/bars in an order of numerical progression; always indicate what numbers are shown, including units (axes, legends).
- Provide complete reference information in the reference section (e.g., including Authors, Title, Journal, Volume, Issue).
- Keep in mind that claims of significance require appropriate statistical tests.
- The writing style should be objective and neutral, in particular in the related work, methodology, and results sections. Clearly indicate when you go beyond the data and develop your own interpretation (e.g., in the form of propositions).
- References: all papers cited in the text are in the reference section, and all papers in the reference section are cited in the text
- The declaration at the end is identical with the declaration shared by the examination office.

<!-- Note: this list is not complete. Please feel free to suggest additional items. -->

Additionally, at least one week before submission, ensure that your thesis meets the following criteria.

## Polishing Your Work for Submission
Expand Down
23 changes: 15 additions & 8 deletions docs/writing/preparation_phase.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,26 @@
---
layout: default
title: "Writing"
title: "Preparation phase"
has_toc: true
parent: "Writing Guide"
nav_order: 2
---

<style>
p {
text-align: justify;
}
</style>

# Preparation Phase

{: .objective }
>
> - Setup
> - Structuring your thesis
> - Creating a General Outline for a Thesis Chapter
> - Example Structure
This page provides a structured guide to initiating your thesis.
It includes essential setup steps and guidance on structuring your thesis.
By following these guidelines, you will lay a solid foundation for your research.
Expand All @@ -16,12 +29,6 @@ By following these guidelines, you will lay a solid foundation for your research

Note: this should roughly be completed within the first week of the thesis.

{: .objective }
> - Setup
> - Structuring your thesis
> - Creating a General Outline for a Thesis Chapter
> - Example Structure
## Setup

To start your thesis on the right track, ensure the following setup steps are completed:
Expand Down Expand Up @@ -141,4 +148,4 @@ While creating an outline, keep the [evaluation criteria](docs/evaluation.html)
> Here is a structure example from a completed thesis.
> You can use this template to structure any of the chapters of your thesis. This will help you with your writing process.
> In addition it is a great document to share with your advisor and talk it through before writing a whole text.
> Here is the [Structure Example](Introduction_Structure - Template.pdf).
> Here is the [Structure Example](Introduction_Structure_Template.pdf).
6 changes: 6 additions & 0 deletions docs/writing/structure_and_contents.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ parent: "Writing Guide"
nav_order: 1
---

<style>
p {
text-align: justify;
}
</style>

# Structure and Contents

{: .objective }
Expand Down
14 changes: 10 additions & 4 deletions docs/writing/writing_phase.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,31 @@
---
layout: default
title: "Structure and Contents"
title: "Writing phase"
has_toc: true
parent: "Writing Guide"
nav_order: 3
---

# Writing Phase
<style>
p {
text-align: justify;
}
</style>

**Bringing Your Thesis to Life**
# Writing Phase

{: .objective }
>
> - Writing in a clear and concise manner
> - Five Golden Rules
> - Writing Process
> - Using Active Voice
> - Topic Sentences
> - Tense Usage in Academic Writing
> - Citation Guidelines
> - When Are Illustrations Needed?
**Bringing Your Thesis to Life**

Writing should be accessible and free of unnecessary complexity to ensure readers easily grasp your ideas.

## Five Golden Rules
Expand Down
14 changes: 10 additions & 4 deletions docs/writing section.md → docs/writing_section.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ has_toc: true
nav_order: 7
---

<style>
p {
text-align: justify;
}
</style>

# Writing Guide

Welcome to the Writing Guide!
Expand All @@ -16,14 +22,14 @@ Whether you're working on your Bachelor's or Master's thesis, this guide will wa
This overview highlights the typical structure and flow of a research thesis.
The thesis process is divided into distinct phases, preparation, writing, and final revisions, which are interconnected and build upon each other.

{: .text-center}
```mermaid
flowchart
structure_and_contents["<a href='#structure_and_contents'>Structure and Contents</a>"] --> preparation["<a href='#preparation_phase'>Preparation</a>"]
preparation --> writing["<a href='#writing_phase'>Writing</a>"]
structure_and_contents["<a href='#structure-and-contents'>Structure and Contents</a>"] --> preparation["<a href='#preparation-phase'>Preparation</a>"]
preparation --> writing["<a href='#writing-phase'>Writing</a>"]
writing --> feedback["<a href='#feedback'>Feedback</a>"]
feedback --> writing
writing --> polishing["<a href='#polishing_phase'>Polishing</a>"]
writing --> polishing["<a href='#polishing-phase'>Polishing</a>"]
```

## Structure and Contents
Expand Down
10 changes: 8 additions & 2 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,11 +163,17 @@ For students of Applied Informatics, Software Systems Science, and Computing in
You are expected to complete the exposé before writing the thesis.
A thesis must be written in English.

Best practices for writing a thesis are linke below:
We offer a comprehensive writing guide offering advice and best practices for all phases of your thesis:

{: .text-center}
[Writing Guide](docs/writing_section){: .btn .btn-green}
{: .text-center}


{: .text-center}
```mermaid
flowchart
structure_and_contents["<a href='docs/writing/structure_and_contents'>Structure and Contents</a>"] --> preparation["<a href='docs/writing/preparation_phase.md'>Preparation</a>"]
structure_and_contents["<a href='docs/writing/structure_and_contents'>Structure and Contents</a>"] --> preparation["<a href='docs/writing/preparation_phase'>Preparation</a>"]
preparation --> writing["<a href='docs/writing//writing_phase'>Writing</a>"]
writing --> feedback["<a href='docs/writing/feedback'>Feedback</a>"]
feedback --> writing
Expand Down

0 comments on commit 640e9e4

Please sign in to comment.