The Style Guide
University of Utah
Y.P. Lee's Algebraic Geometry Class
I, Dylan Zwick, am collating the solutions from chapter 2 of Hartshorne that we're covering in Y.P. Lee's algebraic geometry class. Everybody is expected to type up their assigned problems in latex, and I'm in charge of putting these solutions together in one large solution set for the entire section, and at the end of the class, for the entire chapter. This is a "style guide" I've put together so that all of our solutions will have the same basic format and will fit together nicely when combined. Please try to follow it when typing up your solutions, as it will help me greatly if you do. Thank you very, very much for doing so!
Basic Guidelines
- Include the entirity of your question with your solution, and mark off the question using emphasis. In other words, enclose your entire question in "\emph{}". Things within the question itself that you'd like to have emphasized make bold using "\textbf{}". I'm not completley satisfied with this "\textbf{}" solution, so if anybody has an alternative suggestion, please let me know.
- Separate your solution from the problem by some space, a bolded solution statement giving your name, and then some more space. More precisely, you should separate your solution from the problem statement by using the lines:
      \vspace{.15 in}
      \textbf{Solution by Your Name}
      \vspace{.1 in}
- Each problem will be separated from the next by "\vspace{.35 in}" of vertical space. Although as I'll be doing the collating, you won't have to worry about this yourself.
- You should encapsulate your solution within the description list environment. So, at the beginning of your document you should have "\begin{description}", and your solution should be an item on this list. For example, if you begin a problem with "\item[2.3.5]", this would mean it's problem 5 from section 3 of chapter 2.
- An example illustrating and (hopefully) clarifying all these points is here. The corresponding .pdf file is here.
- When dealing with a question with multiple parts, you should break up your solution into multiple parts as well. What I mean by this is:
- If the question has a number of parts, say (a), (b), (c), write out the question for part (a), then give your solution, then write out the question to part (b), and then give your solution, etc.
- When separating your solution from the part of the question, you only need to include your name in the first one. For the rest of the parts, simply use "\textbf{Solution}".
- Separate individual parts using "\vspace{.25 in}" of vertical space.
- Make sure you use the same numbering scheme as Hartshorne, as later problems might refer back to parts of earlier problems. So, if Hartshorne uses (a), (b), (c) to mark off his parts, you should do the same. If Hartshorne uses (i), (ii), (iii) to mark off his parts, you should do the same.
- An example illustraing and (hopefully) clarifying all these points about multiple parts is here. The corresponding .pdf file is here.
- There's a link at the end of this bullet point with all the libraries I'll be including in the collated solutions. You should copy and paste this onto the top of your solution, so we're all on the same page. If there are other libraries that you'd like to have included, or especially if you've used additional libraries in your solutions, please let me know and I'll add them and include the additional libraries in the future. Thanks. The link with all the libraries is here.
Style Suggestions
I don't want to be patronizing with these, and pretty much all of you already do this before you send me your solutions, so sorry if these seem ridiculous, but I figured I'd include them as just some basic suggestions.
- Make sure the .tex file you send me compiles using latex2e and the standard set of libraries linked to above. If you've added any libraries or definitions or anything at all to the list, please let me know when you email me your .tex file, so I can add what you used to the .tex file with all the solutions, and so I can add the appropriate libraries in the future.
- Check over your work to make sure there are no typos or obvious errors before you send it.
- Read over your solution and try to make sure it's readable. For example, one thing I do is if there's a large block of text, I break it up into distinct sections with some vertical space. Separating sections by "\vspace{.1 in}" I find makes them much more readable.
Of course, the style of your solution is completely up to you. When I'm putting together the solutions I might make some minor changes to other people's solutions. In other words, I might correct a typo or two, add some page breaks, or make some other minor stylistic changes.
I will not change the math or the content of anybody's solution without asking them first. I'm going to try to read through all the solutions as the semester goes on just to make sure I understand them, and if I run across any errors or things I don't understand I might contact the author of the solution. But, as I said, I won't make any content changes on my own, escept of course to my own solutions.
Thank you very much everybody for doing this and for helping me out with it. I very much appreciate it!