Difference between revisions of "Manual of Style"
Abel Maciel (talk | contribs) (→Basic Page Format) |
Abel Maciel (talk | contribs) (→Basic Page Format) |
||
| Line 62: | Line 62: | ||
|Application|| ||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 (Dynamo, Grasshopper, Processing, etc.), one might find internal and external links. | |Application|| ||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 (Dynamo, Grasshopper, Processing, etc.), one might find internal and external links. | ||
|- | |- | ||
| − | |Future Directions|| || | + | |Future Directions|| ||Avoid the term ''Discussion'' as this will be addressed on ''Talk''. |
|- | |- | ||
|Cross-References||Compulsory||to parent topis, children topics adjacent topics. | |Cross-References||Compulsory||to parent topis, children topics adjacent topics. | ||
Revision as of 15:51, 29 August 2016
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.
Contents
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. |
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.
| 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. |
| 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 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 (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. |
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.
