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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
|
<!doctype html>
<html class="default">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>ForgeFed Vocabulary</title>
<link rel="stylesheet" type="text/css" href="/light.css" />
</head>
<body class="body">
<header class="header">
<h1 class="header-title">
<a class="header-title__link" href="/">ForgeFed</a>
</h1>
<nav class="nav">
<a class="nav__link"
href="/forgefed.html">🗲 behavior</a>
<a class="nav__link"
href="/forgefed-vocabulary.html">📓 vocabulary</a>
<a class="nav__link"
href="https://notabug.org/peers/forgefed/issues">🐞 issues</a>
<a class="nav__link"
href="https://talk.feneas.org/c/forgefed">🗪 forum</a>
<a class="nav__link"
href="/index/dark.html">🌑</a>
</nav>
</header>
<main class="main">
<h1 class="main-title">
ForgeFed Vocabulary - draft - 2019-07-30 master
<a href="https://notabug.org/peers/forgefed/commit/88755cac76e2a801aa44a8e53918f9b146ee9fac">
88755ca
</a>
</h1>
<nav class="toc">
<header class="toc-title">Table of Contents</header>
<ul>
<li><a href="#abstract"><span class="toc-section-number">1</span> Abstract</a></li>
<li><a href="#introduction"><span class="toc-section-number">2</span> Introduction</a></li>
<li><a href="#types"><span class="toc-section-number">3</span> Types</a><ul>
<li><a href="#activity-types"><span class="toc-section-number">3.1</span> Activity Types</a><ul>
<li><a href="#push"><span class="toc-section-number">3.1.1</span> Push</a></li>
</ul></li>
<li><a href="#actor-types"><span class="toc-section-number">3.2</span> Actor Types</a><ul>
<li><a href="#repository"><span class="toc-section-number">3.2.1</span> Repository</a></li>
</ul></li>
<li><a href="#object-types"><span class="toc-section-number">3.3</span> Object Types</a><ul>
<li><a href="#commit"><span class="toc-section-number">3.3.1</span> Commit</a></li>
<li><a href="#ticketdependency"><span class="toc-section-number">3.3.2</span> TicketDependency</a></li>
<li><a href="#ticket"><span class="toc-section-number">3.3.3</span> Ticket</a></li>
</ul></li>
</ul></li>
<li><a href="#properties"><span class="toc-section-number">4</span> Properties</a><ul>
<li><a href="#assignedto"><span class="toc-section-number">4.1</span> assignedTo</a></li>
<li><a href="#isresolved"><span class="toc-section-number">4.2</span> isResolved</a></li>
<li><a href="#dependson"><span class="toc-section-number">4.3</span> dependsOn</a></li>
<li><a href="#dependedby"><span class="toc-section-number">4.4</span> dependedBy</a></li>
<li><a href="#dependencies"><span class="toc-section-number">4.5</span> dependencies</a></li>
<li><a href="#dependants"><span class="toc-section-number">4.6</span> dependants</a></li>
<li><a href="#repository-1"><span class="toc-section-number">4.7</span> repository</a></li>
<li><a href="#committedby"><span class="toc-section-number">4.8</span> committedBy</a></li>
<li><a href="#hash"><span class="toc-section-number">4.9</span> hash</a></li>
<li><a href="#committed"><span class="toc-section-number">4.10</span> committed</a></li>
<li><a href="#filesadded"><span class="toc-section-number">4.11</span> filesAdded</a></li>
<li><a href="#filesmodified"><span class="toc-section-number">4.12</span> filesModified</a></li>
<li><a href="#filesremoved"><span class="toc-section-number">4.13</span> filesRemoved</a></li>
</ul></li>
</ul>
</nav>
<p><strong>Editors:</strong></p>
<ul>
<li>deesix</li>
<li>fr33domlover</li>
<li>zPlus</li>
<li>… add other editors</li>
</ul>
<p><strong>Repository:</strong></p>
<ul>
<li><a href="https://notabug.org/peers/forgefed">NotABug</a></li>
</ul>
<p><strong>Copyright:</strong></p>
<p>2019 …</p>
<h1 id="abstract"><span class="header-section-number">1</span> Abstract</h1>
<p>This document describes the ForgeFed vocabulary. It’s intended to be an extension of the <a href="https://www.w3.org/TR/activitystreams-vocabulary/">ActivityPub Vocabulary</a> and provides additional vocabulary for federation of project management and version control system hosting and collaboration platforms.</p>
<h1 id="introduction"><span class="header-section-number">2</span> Introduction</h1>
<p>The ForgeFed Vocabulary describes a set of types and properties to be used by platforms that support the ForgeFed protocol. This specification describes only the new vocabulary called ForgeFed. The ForgeFed behavior specification describes how to use this vocabulary, along with standard ActivityPub vocabulary, to support the ForgeFed protocol.</p>
<h1 id="types"><span class="header-section-number">3</span> Types</h1>
<p>The base URI of all ForgeFed terms is <code>https://forgefed.peers.community/ns#</code>. The ForgeFed vocabulary has a JSON-LD context whose URI is <code>https://forgefed.peers.community/ns</code>. Implementers MUST either include the ActivityPub and ForgeFed contexts in their object definitions, or other contexts that would result with the ActivityPub and ForgeFed terms being assigned they correct full URIs. Implementers MAY include additional contexts and terms as appropriate.</p>
<p>A typical <code>@context</code> of a ForgeFed object may look like this:</p>
<div class="sourceCode" id="cb1"><pre class="sourceCode json"><code class="sourceCode json"><a class="sourceLine" id="cb1-1" title="1"><span class="er">"@context":</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb1-2" title="2"> <span class="st">"https://www.w3.org/ns/activitystreams"</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb1-3" title="3"> <span class="st">"https://forgefed.peers.community/ns"</span></a>
<a class="sourceLine" id="cb1-4" title="4"><span class="ot">]</span></a></code></pre></div>
<h2 id="activity-types"><span class="header-section-number">3.1</span> Activity Types</h2>
<h3 id="push"><span class="header-section-number">3.1.1</span> Push</h3>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#Push</code></p>
<p><strong>Notes:</strong> Indicates that new content has been pushed to the repository. The Activity’s object MUST contain a list of Commits. A Repository actor can use this Activity to notify followers of new changes.</p>
<p><strong>Example:</strong></p>
<div class="sourceCode" id="cb2"><pre class="sourceCode json"><code class="sourceCode json"><a class="sourceLine" id="cb2-1" title="1"><span class="fu">{</span></a>
<a class="sourceLine" id="cb2-2" title="2"> <span class="dt">"@context"</span><span class="fu">:</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb2-3" title="3"> <span class="st">"https://www.w3.org/ns/activitystreams"</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb2-4" title="4"> <span class="st">"https://forgefed.peers.community/ns"</span></a>
<a class="sourceLine" id="cb2-5" title="5"> <span class="ot">]</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb2-6" title="6"> <span class="dt">"summary"</span><span class="fu">:</span> <span class="st">"Alice pushed 2 new commits to Repo2."</span></a>
<a class="sourceLine" id="cb2-7" title="7"> <span class="st">"type"</span><span class="er">:</span> <span class="st">"Push"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb2-8" title="8"> <span class="dt">"actor"</span><span class="fu">:</span> <span class="st">"https://localhost/alice/repo2"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb2-9" title="9"> <span class="dt">"object"</span><span class="fu">:</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb2-10" title="10"> <span class="fu">{</span></a>
<a class="sourceLine" id="cb2-11" title="11"> <span class="dt">"type"</span><span class="fu">:</span> <span class="st">"Commit"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb2-12" title="12"> <span class="fu">}</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb2-13" title="13"> <span class="fu">{</span></a>
<a class="sourceLine" id="cb2-14" title="14"> <span class="dt">"type"</span><span class="fu">:</span> <span class="st">"Commit"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb2-15" title="15"> <span class="fu">}</span></a>
<a class="sourceLine" id="cb2-16" title="16"> <span class="ot">]</span></a>
<a class="sourceLine" id="cb2-17" title="17"><span class="fu">}</span></a></code></pre></div>
<h2 id="actor-types"><span class="header-section-number">3.2</span> Actor Types</h2>
<h3 id="repository"><span class="header-section-number">3.2.1</span> Repository</h3>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#Repository</code></p>
<p><strong>Notes:</strong> Represents a version control system repository.</p>
<p><strong>Example:</strong></p>
<div class="sourceCode" id="cb3"><pre class="sourceCode json"><code class="sourceCode json"><a class="sourceLine" id="cb3-1" title="1"><span class="fu">{</span></a>
<a class="sourceLine" id="cb3-2" title="2"> <span class="dt">"@context"</span><span class="fu">:</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb3-3" title="3"> <span class="st">"https://www.w3.org/ns/activitystreams"</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb3-4" title="4"> <span class="st">"https://forgefed.peers.community/ns"</span></a>
<a class="sourceLine" id="cb3-5" title="5"> <span class="ot">]</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-6" title="6"> <span class="dt">"id"</span><span class="fu">:</span> <span class="st">"https://localhost/alice/forgefed"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-7" title="7"> <span class="dt">"type"</span><span class="fu">:</span> <span class="st">"Repository"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-8" title="8"> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"ForgeFed"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-9" title="9"> <span class="dt">"summary"</span><span class="fu">:</span> <span class="st">"ForgeFed development"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-10" title="10"> <span class="dt">"inbox"</span><span class="fu">:</span> <span class="st">""</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-11" title="11"> <span class="dt">"outbox"</span><span class="fu">:</span> <span class="st">""</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-12" title="12"> <span class="dt">"followers"</span><span class="fu">:</span> <span class="st">""</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb3-13" title="13"> <span class="dt">"following"</span><span class="fu">:</span> <span class="st">""</span></a>
<a class="sourceLine" id="cb3-14" title="14"><span class="fu">}</span></a></code></pre></div>
<h2 id="object-types"><span class="header-section-number">3.3</span> Object Types</h2>
<h3 id="commit"><span class="header-section-number">3.3.1</span> Commit</h3>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#Commit</code></p>
<p><strong>Notes:</strong> Represents a named set of changes to a repository. This is called “commit” in Git, Mercurial and Monotone; “patch” in Darcs; sometimes called “change set”.</p>
<p><strong>Example:</strong></p>
<div class="sourceCode" id="cb4"><pre class="sourceCode json"><code class="sourceCode json"><a class="sourceLine" id="cb4-1" title="1"><span class="fu">{</span></a>
<a class="sourceLine" id="cb4-2" title="2"> <span class="dt">"@context"</span><span class="fu">:</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb4-3" title="3"> <span class="st">"https://www.w3.org/ns/activitystreams"</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb4-4" title="4"> <span class="st">"https://forgefed.peers.community/ns"</span></a>
<a class="sourceLine" id="cb4-5" title="5"> <span class="ot">]</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-6" title="6"> <span class="dt">"id"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice/myrepo/commits/109ec9a09c7df7fec775d2ba0b9d466e5643ec8c"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-7" title="7"> <span class="dt">"type"</span><span class="fu">:</span> <span class="st">"Commit"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-8" title="8"> <span class="dt">"repository"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice/myrepo"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-9" title="9"> <span class="dt">"attributedTo"</span><span class="fu">:</span> <span class="st">"https://example.dev/bob"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-10" title="10"> <span class="dt">"committedBy"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-11" title="11"> <span class="dt">"hash"</span><span class="fu">:</span> <span class="st">"109ec9a09c7df7fec775d2ba0b9d466e5643ec8c"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-12" title="12"> <span class="dt">"name"</span><span class="fu">:</span> <span class="st">"Add an installation script, fixes issue #89"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-13" title="13"> <span class="dt">"description"</span><span class="fu">:</span> <span class="fu">{</span></a>
<a class="sourceLine" id="cb4-14" title="14"> <span class="dt">"mediaType"</span><span class="fu">:</span> <span class="st">"text/plain"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-15" title="15"> <span class="dt">"content"</span><span class="fu">:</span> <span class="st">"It's about time people can install on their computers!"</span></a>
<a class="sourceLine" id="cb4-16" title="16"> <span class="fu">},</span></a>
<a class="sourceLine" id="cb4-17" title="17"> <span class="dt">"created"</span><span class="fu">:</span> <span class="st">"2019-07-11T12:34:56Z"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb4-18" title="18"> <span class="dt">"committed"</span><span class="fu">:</span> <span class="st">"2019-07-26T23:45:01Z"</span></a>
<a class="sourceLine" id="cb4-19" title="19"><span class="fu">}</span></a></code></pre></div>
<h3 id="ticketdependency"><span class="header-section-number">3.3.2</span> TicketDependency</h3>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#TicketDependency</code></p>
<p><strong>Notes:</strong> Represents a relationship between 2 tickets, in which the resolution of one ticket requires the other ticket to be resolved too. It MUST specify the subject, object and relationship properties, and the relationship property MUST be “dependsOn”.</p>
<p><strong>Extends:</strong> <code>Relationship</code></p>
<p><strong>Example:</strong></p>
<div class="sourceCode" id="cb5"><pre class="sourceCode json"><code class="sourceCode json"><a class="sourceLine" id="cb5-1" title="1"><span class="fu">{</span></a>
<a class="sourceLine" id="cb5-2" title="2"> <span class="dt">"@context"</span><span class="fu">:</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb5-3" title="3"> <span class="st">"https://www.w3.org/ns/activitystreams"</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb5-4" title="4"> <span class="st">"https://forgefed.peers.community/ns"</span></a>
<a class="sourceLine" id="cb5-5" title="5"> <span class="ot">]</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-6" title="6"> <span class="dt">"type"</span><span class="fu">:</span> <span class="ot">[</span><span class="st">"Relationship"</span><span class="ot">,</span> <span class="st">"TicketDependency"</span><span class="ot">]</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-7" title="7"> <span class="dt">"id"</span><span class="fu">:</span> <span class="st">"https://example.dev/ticket-deps/2342593"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-8" title="8"> <span class="dt">"attributedTo"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-9" title="9"> <span class="dt">"summary"</span><span class="fu">:</span> <span class="st">"Alice's ticket depends on Bob's ticket"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-10" title="10"> <span class="dt">"published"</span><span class="fu">:</span> <span class="st">"2019-07-11T12:34:56Z"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-11" title="11"> <span class="dt">"subject"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice/myproj/issues/42"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-12" title="12"> <span class="dt">"relationship"</span><span class="fu">:</span> <span class="st">"dependsOn"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb5-13" title="13"> <span class="dt">"object"</span><span class="fu">:</span> <span class="st">"https://dev.community/bob/coolproj/issues/85"</span></a>
<a class="sourceLine" id="cb5-14" title="14"><span class="fu">}</span></a></code></pre></div>
<h3 id="ticket"><span class="header-section-number">3.3.3</span> Ticket</h3>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#Ticket</code></p>
<p><strong>Notes:</strong> Represents an item that requires work or attention. Tickets exist in the context of a project (which may or may not be a version-control repository), and are used to track ideas, proposals, tasks, bugs and more.</p>
<p><strong>Example:</strong></p>
<div class="sourceCode" id="cb6"><pre class="sourceCode json"><code class="sourceCode json"><a class="sourceLine" id="cb6-1" title="1"><span class="fu">{</span></a>
<a class="sourceLine" id="cb6-2" title="2"> <span class="dt">"@context"</span><span class="fu">:</span> <span class="ot">[</span></a>
<a class="sourceLine" id="cb6-3" title="3"> <span class="st">"https://www.w3.org/ns/activitystreams"</span><span class="ot">,</span></a>
<a class="sourceLine" id="cb6-4" title="4"> <span class="st">"https://forgefed.peers.community/ns"</span></a>
<a class="sourceLine" id="cb6-5" title="5"> <span class="ot">]</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-6" title="6"> <span class="dt">"type"</span><span class="fu">:</span> <span class="st">"Ticket"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-7" title="7"> <span class="dt">"id"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice/myrepo/issues/42"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-8" title="8"> <span class="dt">"context"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice/myrepo"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-9" title="9"> <span class="dt">"attributedTo"</span><span class="fu">:</span> <span class="st">"https://dev.community/bob"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-10" title="10"> <span class="dt">"summary"</span><span class="fu">:</span> <span class="st">"Nothing works!"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-11" title="11"> <span class="dt">"content"</span><span class="fu">:</span> <span class="st">"<p>Please fix. <i>Everything</i> is broken!</p>"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-12" title="12"> <span class="dt">"mediaType"</span><span class="fu">:</span> <span class="st">"text/html"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-13" title="13"> <span class="dt">"source"</span><span class="fu">:</span> <span class="fu">{</span></a>
<a class="sourceLine" id="cb6-14" title="14"> <span class="dt">"content"</span><span class="fu">:</span> <span class="st">"Please fix. *Everything* is broken!"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-15" title="15"> <span class="dt">"mediaType"</span><span class="fu">:</span> <span class="st">"text/markdown; variant=CommonMark"</span></a>
<a class="sourceLine" id="cb6-16" title="16"> <span class="fu">},</span></a>
<a class="sourceLine" id="cb6-17" title="17"> <span class="dt">"assignedTo"</span><span class="fu">:</span> <span class="st">"https://example.dev/alice"</span><span class="fu">,</span></a>
<a class="sourceLine" id="cb6-18" title="18"> <span class="dt">"isResolved"</span><span class="fu">:</span> <span class="kw">false</span></a>
<a class="sourceLine" id="cb6-19" title="19"><span class="fu">}</span></a></code></pre></div>
<h1 id="properties"><span class="header-section-number">4</span> Properties</h1>
<h2 id="assignedto"><span class="header-section-number">4.1</span> assignedTo</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#assignedTo</code></p>
<p><strong>Notes:</strong> Identifies the person assigned to work on this ticket.</p>
<p><strong>Domain:</strong> <code>Ticket</code></p>
<p><strong>Range:</strong> <code>Person</code></p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="isresolved"><span class="header-section-number">4.2</span> isResolved</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#isResolved</code></p>
<p><strong>Notes:</strong> Specifies whether the ticket is closed, i.e. the work on it is done and it doesn’t need to attract attention anymore.</p>
<p><strong>Domain:</strong> <code>Ticket</code></p>
<p><strong>Range:</strong> <code>xsd:boolean</code></p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="dependson"><span class="header-section-number">4.3</span> dependsOn</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#dependsOn</code></p>
<p><strong>Notes:</strong> Identifies one or more tickets on which this ticket depends, i.e. it can’t be resolved without those tickets being resolved too.</p>
<p><strong>Domain:</strong> <code>Ticket</code></p>
<p><strong>Range:</strong> <code>Ticket</code></p>
<p><strong>Functional:</strong> No</p>
<p><strong>Inverse of:</strong> <a href="#dependedby">dependedBy</a></p>
<p><strong>Example:</strong></p>
<h2 id="dependedby"><span class="header-section-number">4.4</span> dependedBy</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#dependedBy</code></p>
<p><strong>Notes:</strong> Identifies one or more tickets which depends on this ticket, i.e. they can’t be resolved without this tickets being resolved too.</p>
<p><strong>Domain:</strong> <code>Ticket</code></p>
<p><strong>Range:</strong> <code>Ticket</code></p>
<p><strong>Functional:</strong> No</p>
<p><strong>Inverse of:</strong> <a href="#dependson">dependsOn</a></p>
<p><strong>Example:</strong></p>
<h2 id="dependencies"><span class="header-section-number">4.5</span> dependencies</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#dependencies</code></p>
<p><strong>Notes:</strong> Identifies a <code>Collection</code> of <code>TicketDependency</code> which specify tickets that this ticket depends on, i.e. this ticket is the <code>subject</code> of the <code>dependsOn</code> relationship.</p>
<p><strong>Domain:</strong> <code>Ticket</code></p>
<p><strong>Range:</strong> <code>Collection</code> (of items of type <code>TicketDependency</code>)</p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="dependants"><span class="header-section-number">4.6</span> dependants</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#dependants</code></p>
<p><strong>Notes:</strong> Identifies a <code>Collection</code> of <code>TicketDependency</code> which specify tickets that depends on this ticket, i.e. this ticket is the <code>object</code> of the <code>dependsOn</code> relationship. Often called “reverse dependencies”.</p>
<p><strong>Domain:</strong> <code>Ticket</code></p>
<p><strong>Range:</strong> <code>Collection</code> (of items of type <code>TicketDependency</code>)</p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="repository-1"><span class="header-section-number">4.7</span> repository</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#repository</code></p>
<p><strong>Notes:</strong> Identifies the repository to which a commit belongs.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>Repository</code></p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="committedby"><span class="header-section-number">4.8</span> committedBy</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#committedBy</code></p>
<p><strong>Notes:</strong> Identifies the actor (usually a person, but could be something else, e.g. a bot) that added a set of changes to the version-control repository. Sometimes the author of the changes and the committer of those changes aren’t the same actor, in which case the <code>committedBy</code> property can be used to specify who added the changes to the repository. For example, when applying a patch to a repository, e.g. a Git repository, the author would be the person who made the patch, and the committer would be the person who applied the patch to their copy of the repository.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>Object</code></p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="hash"><span class="header-section-number">4.9</span> hash</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#hash</code></p>
<p><strong>Notes:</strong> Specifies the hash associated with a commit, which is a unique identifier of the commit within the repository, usually generated as a cryptographic hash function of some (or all) of the commit’s data or metadata. For example, in Git it would be the SHA1 hash of the commit; in Darcs it would be the SHA1 hash of the patch info.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>xsd:string</code> of hexadecimal digit ASCII characters</p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="committed"><span class="header-section-number">4.10</span> committed</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#committed</code></p>
<p><strong>Notes:</strong> Specifies the time that a set of changes was committed into the repository and became a commit in it. This can be different from the time the set of changes was produced, e.g. if one person creates a patch and sends to another, and the other person then applies the patch to their copy of the repository. We call the former event “created” and the latter event “committed”, and this latter event is specified by the <code>committed</code> property.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>xsd:dateTime</code></p>
<p><strong>Functional:</strong> Yes</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="filesadded"><span class="header-section-number">4.11</span> filesAdded</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#filesAdded</code></p>
<p><strong>Notes:</strong> Specifies a filename, as a relative path, relative to the top of the tree of files in the repository, of a file that got added in this commit, and didn’t exist in the previous version of the tree.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>xsd:string</code></p>
<p><strong>Functional:</strong> No</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="filesmodified"><span class="header-section-number">4.12</span> filesModified</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#filesModified</code></p>
<p><strong>Notes:</strong> Specifies a filename, as a relative path, relative to the top of the tree of files in the repository, of a file that existed in the previous version of the tree, and its contents got modified in this commit.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>xsd:string</code></p>
<p><strong>Functional:</strong> No</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
<h2 id="filesremoved"><span class="header-section-number">4.13</span> filesRemoved</h2>
<p><strong>URI:</strong> <code>https://forgefed.peers.community/ns#filesRemoved</code></p>
<p><strong>Notes:</strong> Specifies a filename, as a relative path, relative to the top of the tree of files in the repository, of a file that existed in the previous version of the tree, and got removed from the tree in this commit.</p>
<p><strong>Domain:</strong> <code>Commit</code></p>
<p><strong>Range:</strong> <code>xsd:string</code></p>
<p><strong>Functional:</strong> No</p>
<p><strong>Inverse of:</strong> (None)</p>
<p><strong>Example:</strong></p>
</main>
<footer class="footer">
<p xmlns:dct="http://purl.org/dc/terms/">
<a rel="license"
href="http://creativecommons.org/publicdomain/zero/1.0/">
<img src="https://licensebuttons.net/p/zero/1.0/88x31.png"
style="border-style: none;"
alt="CC0" />
</a>
<br />
<a rel="dct:publisher" href="https://peers.community">
<span property="dct:title">The ForgeFed team</span>
</a>
has dedicated all copyright and related and neighboring
rights to
<span property="dct:title">ForgeFed</span> to the public domain
worldwide.
</p>
<p>❤ Copying is an act of love. Please copy, reuse and share!</p>
<p>
Site generated by
<a class="footer__link" href="https://pandoc.org">pandoc</a>.
</p>
</footer>
</body>
</html>
|
