bell notificationshomepageloginNewPostedit profile

Topic : 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. - selfpublishingguru.com

10.02% popularity

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?


Load Full (2)

Login to follow topic

More posts by @BetL639

2 Comments

Sorted by latest first Latest Oldest Best

10% popularity

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.


Load Full (0)

10% popularity

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!)


Load Full (0)

Back to top