Manual of Style

From Design Computation
Revision as of 15:26, 29 August 2016 by Abel Maciel (talk | contribs) (History & Theory pages)

Jump to: navigation, search

The Manual of Style (abbreviated as DCMoS, DCMOS or MoS) is the style manual for all Design Computation articles. This primary page of the guideline covers certain topics (e.g. punctuation) in detail and summarizes the key points of other topics. The detail pages, which are cross-referenced here and linked by this page's menu, provide specific guidance on those topics. If any contradiction arises, this page has precedence over all detail pages of the guideline.

Guidelines to categorizing pages

Design Computation wiki generates a page collating all categorizations applied in the database.

Super-Category Description
Historical Historical
Method Tagging methodological knowledge
Category Description
Manufacturing Fabrication methods
Simulation modelling simulation methods

Types of Pages

Design Computation wiki generates a page collating all categorizations applied in the database.

Page Type Description
Historical History of a method, process, etc.
Theoretical Theory of a method, process, etc.
Case Study Illustration by case study.
Implementation Code, Script and tactics.

History & Theory pages

History and theory pages uses similar style to Wikipedia but are somehow shorter and focus only on computational design taxonomies, cultures and ontologies.

Page Session Sub-Session Description
Title Name of the page. Please check if the page already exists by running a search.
Author Name of authors and link to authors' pages.
Synonyms Equivalent topics in order of similitude,listed from equivalent to least equivalent. Hyperlinked.
Definition An abstract defining the topic.
Motivation & Background The theoretical framework, reasoning, Intellectual background. Includes detailed Characteristics and Theory.
Structures The mechanism depiction of the topic clarifying Principle, Precision and Generality of the method or theory.
Application Description of cases and application with steps-by-step explanations.
Examples Illustrations, including scrips and computer code or mathematical model by the many design development platform available listed in alphabetical order. For each platform (Dynamo, Grasshopper, Processing, etc.), one might find internal and external links.
Future Directions Also can be called Discussion.
Cross-References to parent topis, children topics adjacent topics.
Recommended Reading List of directly and indirectly related references.

Methods, Applications & Tutorials pages

Application pages refer to material and methods shared by contributors for the resolution of design issues. This is often associated to live projects in the industry.

Tutorial pages contains a Title, with the abstract (no heading) following, the Principle explaining in detail the underpinning mathematical rationale of the principle being applied, the Steps explaining different codes and finally, whenever possible the Download for tutorial files.

Page Session Sub-Session Description
Title Description
Abstract Description
1. Theorem The problem specification
2. Proposition Description
2.1 Principle Description
2.2 Precision Description
2.3 Generality Description
3. Execution Description
3.1 Steps Step by step implementation of the method.
3.2 Remarks Any remarks on paradoxes, oddities, etc. in the implementation.
4. Sources Links for the many design development platform available listed in alphabetical order. For each platform, one might find internal and external links.
C# Internal and external links
Catia Internal and external links
Dynamo Internal and external links
Grasshopper Internal and external links
Java Internal and external links
JavaScript Internal and external links
OpenFrameworks Internal and external links
Processing Internal and external links
Python Internal and external links
5. Contacts Names of contributors

References

Classic referencing for the tutorial.

Bibliography

Relevant literature related to tutorial.