Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revision | |
| people:etanter:writing-tips [2018/06/10 08:14] – etanter | people:etanter:writing-tips [2018/06/10 08:14] (current) – etanter |
|---|
| * **Clearly identify the reusable brain stuff.** ([[http://research.microsoft.com/en-us/people/simonpj/|Simon Peyton-Jones]]) Most probably, people are not interested in the actual prototype you are building. Rather, you should make clear what the "intellectual added value" (aka. reusable brain stuff) of your work is. What do I learn from this work, that can be applied and reused in other contexts? For this you must make a specific effort to filter out the details from the essence. | * **Clearly identify the reusable brain stuff.** ([[http://research.microsoft.com/en-us/people/simonpj/|Simon Peyton-Jones]]) Most probably, people are not interested in the actual prototype you are building. Rather, you should make clear what the "intellectual added value" (aka. reusable brain stuff) of your work is. What do I learn from this work, that can be applied and reused in other contexts? For this you must make a specific effort to filter out the details from the essence. |
| |
| * **A thesis(/paper) is not finished when there is nothing more to add.** ([[http://www.diku.dk/~eric|Eric Jul]], channeling [[https://en.wikiquote.org/wiki/Antoine_de_Saint_Exup%C3%A9ry|Antoine de Saint Exupéry]]) It is finished when there is nothing more to remove. Every single sentence/paragraph/section is a candidate for removal. Does it add something useful or necessary? Does it detract from the main argument? | * **A thesis or paper is not finished when there is nothing more to add.** ([[http://www.diku.dk/~eric|Eric Jul]], channeling [[https://en.wikiquote.org/wiki/Antoine_de_Saint_Exup%C3%A9ry|Antoine de Saint Exupéry]]) It is finished when there is nothing more to remove. Every single sentence/paragraph/section is a candidate for removal. Does it add something useful or necessary? Does it detract from the main argument? |
| |
| * **Adopt structured and modular writing.** A major challenge is to organize the flow of ideas coherently. Analyze the structure and the dependencies between the different sentences/paragraphs/sections. Avoid repetitions. Prefer back references to forward references. Don't be afraid of refactoring! | * **Adopt structured and modular writing.** A major challenge is to organize the flow of ideas coherently. Analyze the structure and the dependencies between the different sentences/paragraphs/sections. Avoid repetitions. Prefer back references to forward references. Don't be afraid of refactoring! |
