Manual of Style

From Design Computation
Revision as of 15:55, 7 September 2016 by Abel Maciel (talk | contribs) (Basic Page Format)

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.

Page Types

Design Computation wiki generates a page collating all categorizations applied in the database. Pages will distinguished between Historical, Theoretical, Case Studies and Application.

Basic Page Format

Pages in designcomputation.org are as short as possible and focus only on computational design taxonomies, cultures and ontologies. A page might be a simple definition that gradually evolves to have Motivation & Background, Structures and Applications with many detailed subtopics. Use the Basic Page Template to copy and paste the code formatting your new page.

Page Session Status Description
Category (Invisible) Add a category to the page. Check on the category pages for the database or create a new one if existent.
Title Compulsory Please create page by searching first (top-right of the screen).
Abstract Compulsory Create a short abstract to introduce the page. The abstract does not need a heading. This will not have a heading and will appear on the top of the page under the title.
Synonyms Compulsory Equivalent topics in order of similitude,listed from equivalent to least equivalent. Hyperlinked.
Definition Compulsory An abstract defining the topic and outlining the main Propositions of 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. This includes or links to Examples with scrips, computer code or mathematical model illustrating the application in the many design development platform available (listed on table in alphabetical order). For each platform (Dynamo, Grasshopper, Processing, etc.), one might find internal and external links.
Future Directions Avoid the term Discussion as this will be addressed on Talk.
Cross-References Compulsory to parent topis, children topics adjacent topics.
Recommended Reading Compulsory List of directly and indirectly related references.

Application 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. Use the Application Page Template to copy and paste formatting on your new page.

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 Status Description
Category (Invisible) Add a category to the page. Check on the category pages for the database or create a new one if existent.
Title Compulsory Name of the page. Please check if the page already exists by running a search.
Author Compulsory Name of authors and link to authors' pages.
Synonyms Compulsory Equivalent topics in order of similitude,listed from equivalent to least equivalent. Hyperlinked.
Definition Compulsory An abstract defining the topic and outlining the main Propositions of the topic. Also defining the structure of the mechanism depiction of the topic clarifying Principle, Precision and Generality of the method or theory.
Application Compulsory Description of cases and application with steps-by-step explanations. This includes Examples with scrips, computer code or mathematical model illustrating the application in the many design development platform available (listed in alphabetical order). For each platform (e.g. Design Script) one might find internal and external links. Some platforms for design computation development are C#, Catia, Dynamo, Grasshopper, Java, JavaScript, OpenFrameworks, Processing, Python, etc.
Cross-References Compulsory to parent topis, children topics adjacent topics.
Recommended Reading Compulsory List of directly and indirectly related references.