forked from corlab/dslzoo
-
Notifications
You must be signed in to change notification settings - Fork 0
/
contribute.html
127 lines (104 loc) · 8.03 KB
/
contribute.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
<meta name="author" content="">
<link rel="icon" href="images/favicon.png">
<title>Contribute – Robotics DSL Zoo</title>
<link href="dist/css/bootstrap.min.css" rel="stylesheet">
<link rel="stylesheet" type="text/css" href="sortable/bootstrap-sortable.css">
<link rel="stylesheet" type="text/css" href="dist/css/custom.css">
<script language="javascript" type="text/javascript" src="flot/jquery.js"></script>
<script language="javascript" type="text/javascript" src="flot/jquery.flot.js"></script>
<script language="javascript" type="text/javascript" src="flot/jquery.flot.categories.js"></script>
<script type="text/javascript" src="dist/d3-cloud/lib/d3/d3.js"></script>
<script type="text/javascript" src="dist/d3-cloud/d3.layout.cloud.js"></script>
<script type="text/javascript" src="js/main.js"></script>
</head>
<body><nav class="navbar navbar-inverse navbar-fixed-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="./index.html">Robotics DSL Zoo</a>
</div>
<div id="navbar" class="collapse navbar-collapse">
<ul class="nav navbar-nav">
<li><a href="./index.html">Home</a></li>
<li><a href="./subdomains.html">Subdomains</a></li>
<li><a href="./architectures-and-programming-disciplines.html">A&P Disciplines</a></li>
<li><a href="./phases.html">Development Phases</a></li>
<li><a href="./all.html">Index</a></li>
<li class="active"><a href="./contribute.html">Contribute</a></li>
<li><a href="http://www.dslrob.org">DSLRob</a></li>
</ul>
</div><!--/.nav-collapse -->
</div>
</nav>
<div class="container">
<div class="starter-template">
<h1>Robotics DSL Zoo</h1>
<h2>Contribute</h1>
<table><tr><td> <p><b>We are constantly updating and extending the Robotics DSL Zoo and are waiting for your input!</b></p> <td/><td> </td></tr></table><p>All sources of this Robotics DSL Zoo are hosted in github in <a href="https://github.com/corlab/dslzoo">corlab/dslzoo</a>. Fell free to fork the repository and make additions to the source files. Check github help on <a href="https://help.github.com/articles/using-pull-requests/">pull requests</a> on how to request your changes to be added to the DSL Zoo website. Some guidelines to make it easier for you and us:</p><h3>Requirements</h3><p>We impose some requirements for a publication to be added to the Robotics DSL Zoo. Please check, before adding a publication:<ol><li><b>Technical:</b><br />The publication describes a domain-specific language or its usage. Only (meta-)models is not enough, we want to see at least some kind of syntax, grammar or language examples.</li><li><b>Content-wise:</b><br />Robotics is an interdisciplinary research field. In order to somehow limit the scope of this DSL zoo we introduced <a href="domain-examples.html">domain examples</a> that describe the variability of the field and give us an idea of the subdomains that are relevant in robotics. Please check before adding a publication, if the discussed DSL belongs to one of these <a href="subdomains.html">subdomains</a> or provides support for one of the <a href="domain-examples.html">domain examples</a>.</li></ol></p><h3>Workflow - Adding a Publication / DSL</h3><p>The domain-specific language publications are collected in a <a href="https://en.wikipedia.org/wiki/BibTeX">BibTeX</a> file, which is a common format to manage publication lists. If you want to make additions to the overall DSL Zoo, add a new entry to <a href="https://github.com/corlab/dslzoo/blob/master/dslzoo.bib">dslzoo.bib</a><!--. If you want to make an addition to the <a href="./index.html#annotated-bibliography">annotated bibliography</a>, add a new entry to <a href="https://github.com/corlab/dslzoo/blob/master/publications/annotated.bib">publications/annotated.bib</a>-->, including a 2-3 sentence summary of the core contribution.
<ol>
<li>Go on github and fork the <a href="https://github.com/corlab/dslzoo">corlab/dslzoo repository</a>.</li>
<li>Add a new entry to <a href="https://github.com/corlab/dslzoo/blob/master/dslzoo.bib">dslzoo.bib</a> of your fork. The format is:</p>
<div style="font-style:monospace;border:1px solid #d3d7cf;font-size:90%;background-color:#eeeeec;">
@inproceedings{surnameyearfirstword,<br />
annote = {Your two to three sentence summary of the core contribution},<br />
author = {John Doe and Other Authors},<br />
booktitle = {International Conference on DSL Stuff},<br />
doi = {12.3456/DOI.1234.1234567},<br />
isbn = {978-1-2345-5678-9},<br />
keywords = {dsl-zoo, ...},<br />
month = jan,<br />
pages = {12--34},<br />
publisher = {IEEE},<br />
title = {Publication Title},<br />
url = {http://publication.link},<br />
year = {2016},<br />
zoo-subdomains = {Kinematics, Dynamics, Mechanisms and Actuation, Sensing and Estimation, Motion Planning, Motion Control, Force Control, Architectures and Programming, Reasoning Methods},<br />
zoo-ap-subdomains = {Concurrency, Control and Handling of Events, Data Persistence, Distribution of Components, Error and Exception Handling and Fault Tolerance, Interaction and Presentation, Security and Safety, Architectural Structures and Viewpoints, Architectural Styles, Design Patterns, Architecture Design Decisions, Families of Programs and Frameworks},<br />
zoo-phases = {Scenario Building, Functional Design, Platform Building, Capability Building, System Deployment, System Benchmarking, Product Deployment, Product Maintenance},<br />
zoo-tool = {DSL Tool / Workbench (e.g. 'EMF xtext')},<br />
zoo-website = {http://dsl.homepage.link},<br />
zoo-download = {http://dsl.download.link},<br />
}<br />
</div>
<p>There are a lot of free BibTeX tools out there to support you with this format, some of them might hide the zoo-specific custom fields though.</p></li>
<li>After you added a publication, place a <a href="https://help.github.com/articles/using-pull-requests/">pull requests</a> (preferably one for each publication) to <a href="https://github.com/corlab/dslzoo">corlab/dslzoo</a>.</p></li>
</ol>
</div>
</div>
<div class="container">
<br />
<hr />
<p style="font-size:85%; color:#555;">An important DSL is missing? Here is how to <a href="./contribute.html">contribute</a>! When using content of the Robotics DSL Zoo or referring to it, pleace consider citing our survey paper:
<pre>
@article{nordmann2016survey,
author = {Nordmann, Arne and Hochgeschwender, Nico and Wigand, Dennis Leroy and Wrede, Sebastian},
journal = {Journal of Software Engineering in Robotics (JOSER)},
number = {1},
pages = {75--99},
title = {{A Survey on Domain-Specific Modeling and Languages in Robotics}},
volume = {7},
year = {2016},
}
</pre>
<br />
<a style="font-size:85%; color:#555;" title="A Survey on Domain-Specific Modeling and Languages in Robotics" href="http://joser.unibg.it/index.php?journal=joser&page=article&op=view&path%5B%5D=100">A. Nordmann, N. Hochgeschwender, D. Wigand and S. Wrede, “A Survey on Domain-Specific Modeling Languages in Robotics”, Journal of Software Engineering for Robotics (JOSER), 2016</a>
</p>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
<script src="dist/js/bootstrap.min.js"></script>
<script src="sortable/moment.min.js"></script>
<script src="sortable/bootstrap-sortable.js"></script>
</body>
</html>