: How to name sections containing only source code in appendix? I am writing on my thesis, containing a lot of implementations. Due to readability, I locate all my source code in the Appendix.
I am writing on my thesis, containing a lot of implementations. Due to readability, I locate all my source code in the Appendix. Is there a style guide on how to name these sections in the Appendix?
Currently, my approach is to structure them like this:
A. General Methods
A.1. def foo
A.2. def bar
B. Specific Methods
B.1. def ...
C. Further Methods
However, this looks kinda strange in my ToC, is there any style guide on how to name sections only containing source code?
More posts by @BetL639
: Compelling story with the world as a villain My main character is up against the world, or, rather, the world and reality are up against her. A good story is in some ways defined by its
: Scale refers to how large or small something is. In writing terms, scale refers to how big a problem or conflict is, in terms of how much it affects. If the conflict is confined to one
2 Comments
Sorted by latest first Latest Oldest Best
Where I did my PhD there were no relevant guidelines; such a level of detail in submission guidelines is uncommon in the UK. I stuck to my usual rule of academic writing: be clear and help the reader. Each main piece of code was a section (in one code-appendix) with a descriptive title that appeared in the ToC:
Appendix A Analysis source code
A.1 Peak picking code
A.2 Thermal simulation spatial averaging code
A.3 EL hotspot image analysis code
Coming up with short captions (to go in lists of figures, tables, etc.) is something you're likely to be doing anyway as you polish the thesis.
As an aside, I suggest you introduce each bit of code in your appendices (however well it's described in the body, and however well it's commented inline) as you would caption a figure so it makes sense on its own. You've probably already done this.
Sometimes the department (or school of graduate studies at you institution) will have a very specific set of style guidelines for theses -- check there first. After that, go to your institution's library and have a look at previous theses in your discipline. If there is no specific guidance there, refer to the style guides for the journals in your discipline. Also consider talking with the post-docs and researchers in your supervisor's group. Should all that fail, hash-out a structure yourself, then bring all the leg-work you've done to your supervisor, and ask for their opinion.
(PS: Congrats on your approaching submission!)
Terms of Use Privacy policy Contact About Cancellation policy © selfpublishingguru.com2024 All Rights reserved.