Calculus/Contributing

Notes on contributing to the Calculus textbook. This is the Local manuals of style for the Calculus textbook.

Note to new contributors
The guidelines given below are intended to keep the organization and style of the book consistent, to reduce the need to rework edits, and to communicate best practices. It is not intended to be a barrier to contributions by would-be contributors. If you have something to contribute but don't have time to read up on all the guidelines given below, go ahead and make your contribution. Other experienced contributors can touch up your edits afterwards so that they conform to the guidelines.

Structure
The structure currently being implemented is as follows:
 * The book is divided into chapters and sections, with related sections grouped into supersections (e.g. Integration Techniques within the Integration chapter). These sections are listed on the main page.
 * Each section is assigned a section number.
 * "==" should be the highest level header used in any section. "=" is reserved for major divisions within the print version of the book.
 * Each page including exercises links to a corresponding page of solutions.
 * Pages of solutions are organized based on their corresponding page of exercises (exercises set one has a corresponding set one of solutions, etc.).

Conventions

 * Use templates to separate chapters and sections in the print version.
 * Section titles should use title casing while sub-section headers should use sentence casing. Named theorems should be capitalized (e.g. Mean Value Theorem).
 * All content pages and section pages should include the template at the top and bottom of the page. This template links to the previous and next section or content page. The order of pages defined by the links in the  template should agree with all tables of contents.
 * All content pages and section pages should include just below the bottom  template.
 * Whenever you want to refer to a section by its section number, use . Then any changes in the ordering of sections can be done easily by changing the  template.
 * Exercises are sequentially numbered within each section.
 * Solutions should be complete and logical. Particularly important steps should be noted and described in words as well as being shown symbolically. Naming Convention: Calculus/[Section-Name]/Solutions (ex. Calculus/Differentiation/Solutions)
 * Give each figure a figure number. Figure numbering restarts with each new section.
 * Use and  for inline math text that shouldn't be broken up across lines.
 * Link figure references in the text to the figure's file using Figure k.
 * Use "\left(" and "\right)" for parenthesis, "\left|" and "\right|" for absolute values, etc. This makes the LaTeX render better in many cases.
 * Use an invisible delimiter (i.e. "\.") with "\|_a^b" for evaluating the antiderivative of an definite integral. The invisible delimiter causes the size of the vertical bar to be sized according to the size of the expression being evaluated.
 * Use question-answer templates for exercises like this:
 * The noprint template prevents the answer from appearing with the exercise in the print version.
 * The noprint template prevents the answer from appearing with the exercise in the print version.


 * Solutions (as opposed to answers) go on the solutions page like this:
 * Bold the answer using either Answer or $$\mathbf{Answer}$$ so that people using the print version can quickly find the answer.
 * Bold the answer using either Answer or $$\mathbf{Answer}$$ so that people using the print version can quickly find the answer.


 * Prefer \frac{a}{b} to {a\over b}. Using consistent markup reduces the need to do multiple searches on different search terms if looking for a particular fraction.
 * Use a single space between sentences unless there is a specific reason to do otherwise. Extra whitespace is ignored anyway, so adding extra whitespace only adds to the size of the page without changing its appearance. If you need to add extra whitespace for layout, use "&amp;nbsp;" (the html code for a space) within text or "\,", "\quad", or "\qquad" within tags for small, medium, and large spaces, respectively.

Templates
See /Templates for a list of all Calculus textbook templates.

produces this navigation box:

All Calculus content pages should include this at the top of the page and at the bottom just above the   template.

produces this navigation box:

All Calculus content pages should include this at the bottom of the page. This also adds the page to |the book category.

returns the section number for the Algebra section, i.e. . Use this template when you want to refer to a section by its section number. If you re-order the sections, edit the template to reflect the new ordering. That way all references in the book will be updated to return the correct section number.

produces a box for important text:

Use this to introduce significant new definitions and concepts. See Calculus/Limits, where the informal definition of a limit is inside such a box.

produces a stub notice, signifying that the given page or section is too short.

On inclusiveness vs. exclusiveness
An Extensions section is included for further topics. Any study beyond fairly basic calculus should be in this section. We should aim to include more than is necessary and ensure that our readers are aware of this. The book should be structured so that J. Random Student can find a rigorous course in the essentials of calculus but also include further study of the topic that readers can pick and choose topics from, as their interests warrant.

TODO

 * ADD MORE, ORGANIZE MORE.
 * Provide a more in-depth Precalculus section.
 * Create problem sets (preferably original, rigorous and realistic).
 * Create answer sets.