-
Notifications
You must be signed in to change notification settings - Fork 2
/
AudienceDefinitionAndUse.txt,v
420 lines (350 loc) · 17.7 KB
/
AudienceDefinitionAndUse.txt,v
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
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
head 1.17;
access;
symbols;
locks; strict;
comment @# @;
1.17
date 2009.11.25.03.14.30; author GarryJolleyRogers; state Exp;
branches;
next 1.16;
1.16
date 2009.11.20.02.45.22; author LeeBelbin; state Exp;
branches;
next 1.15;
1.15
date 2007.03.06.17.30.00; author TWikiGuest; state Exp;
branches;
next 1.14;
1.14
date 2006.05.04.11.26.28; author GregorHagedorn; state Exp;
branches;
next 1.13;
1.13
date 2004.12.18.02.28.06; author BobMorris; state Exp;
branches;
next 1.12;
1.12
date 2004.12.17.23.02.11; author BobMorris; state Exp;
branches;
next 1.11;
1.11
date 2004.12.17.18.51.57; author BobMorris; state Exp;
branches;
next 1.10;
1.10
date 2004.06.21.11.30.00; author GregorHagedorn; state Exp;
branches;
next 1.9;
1.9
date 2004.05.28.17.35.56; author GregorHagedorn; state Exp;
branches;
next 1.8;
1.8
date 2004.05.28.15.26.23; author GregorHagedorn; state Exp;
branches;
next 1.7;
1.7
date 2003.11.24.10.38.00; author GregorHagedorn; state Exp;
branches;
next 1.6;
1.6
date 2003.10.10.06.11.04; author BobMorris; state Exp;
branches;
next 1.5;
1.5
date 2003.10.09.20.59.15; author KevinThiele; state Exp;
branches;
next 1.4;
1.4
date 2003.10.06.21.49.37; author BobMorris; state Exp;
branches;
next 1.3;
1.3
date 2003.10.05.20.24.52; author BobMorris; state Exp;
branches;
next 1.2;
1.2
date 2003.10.05.18.58.34; author BobMorris; state Exp;
branches;
next 1.1;
1.1
date 2003.10.05.17.13.00; author BobMorris; state Exp;
branches;
next ;
desc
@none
@
1.17
log
@none
@
text
@%META:TOPICINFO{author="GarryJolleyRogers" date="1259118870" format="1.1" version="1.17"}%
%META:TOPICPARENT{name="ClosedTopicSchemaDiscussionSDD09"}%
---+!! %TOPIC%
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to support applications that recognize more properties of a human user than just language. As of Version 0.62 an <nop>AudienceDefinition object has three required attributes:
* a key by which keyrefs can be used elsewhere to indicate that this <nop>AudienceDefinition is the one referenced
* a lang attribute. It is of type xs:language, which will require it (under validation) to have one of the ISO standard language abbreviations as required by xxxx
* an <nop>ExpertiseLevel The value of this must be one of the integers 1-5 (this constraint is enforced by the schema by declaring a data type <nop>ExpertiseLevelType. That means future changes---hopefully backward compatible---could permit other values simply by changing that type.
It is the attributes which most applications will find most useful, because they will use the latter two in tailoring user interfaces. A typical use of Audience references might be in a <nop>CharacterDefinition that has several different text parts, each with a different intended Audience. The application could select the accompanying text based on the Audience.
In addition to those attributes there are two subelements - a label and a description, both strings. 0.62 ascribes no enforceable semantics to these, but the intent is captured by the schemadoc entry:
<verbatim>
<xs:documentation source="G. Hagedorn" xml:lang="en">An audience is a combination of language (including dialect) and expertise (pupil, beginner, expert). Multiple audiences can be defined for the same language and expertise, distinguished only by their label.</xs:documentation>
</verbatim>
Presumably, the label and description of an audience would be in the language and perhaps presumed ability of the audience, if an application is going to be able to make use of them for descriptions of the audience itself. However, such a description is not really within the scope of SDD, so there is no semantic recommendation at this writing.
A documentation element in the 0.62 schema records the committee's design intention for the integers in the <nop>ExpertiseLevel. They are described by this schema doc element on the
<verbatim>
<xs:documentation source="G. Hagedorn" xml:lang="en">ExpertiseLevel is restricted to values from 1-5. These categories allow to communicate expected expertise between different applications using the SDD schema. The recommended interpretation is:
1 = elementary school (year 1 to 6);
2 = middle school (year 7 to 10);
3 = high school (year 11 above) and general public (trying to avoid any specialized terminology or jargon);
4 = university students or (partly) trained personnel (using terminology, but avoiding or explaining problematic terminology);
5 = experts (using the full range of terminology).</xs:documentation>
</verbatim>
In 0.91, <nop>AudienceDefinitions are described in the <nop>GeneralDeclarations section and referenced in many places by keyrefs in attributes always of name "audience".
-- Main.BobMorris - 05 Oct 2003/ Gregor Hagedorn 28. May 2004
---
In 1.0 versions, <nop>AudienceRelationID, which defines the pattern for Audience keys, is defined by restriction from UBIF's <nop>RelationID. However, that must be an integer, whereas we intend(?) to have mnemonic audience keys in SDD, using some brief strings like en5. XML Spy2004v4 does not enforce this (undesirable) constraint, though Apache does (I think) and so does the embedded parser in Stylus Studio Home Edition
-- Main.BobMorris - 17 Dec 2004
%META:TOPICMOVED{by="BobMorris" date="1065374722" from="SDD.AudienceDefinitionsAndUse" to="SDD.AudienceDefinitionAndUse"}%
@
1.16
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="LeeBelbin" date="1258685122" format="1.1" reprev="1.16" version="1.16"}%
d5 1
a5 1
XML supports the specification of a natural language through use of the "lang" attribute on an element. BDI.SDD means to extend this notion to support applications that recognize more properties of a human user than just language. As of Version 0.62 an <nop>AudienceDefinition object has three required attributes:
d17 1
a17 1
Presumably, the label and description of an audience would be in the language and perhaps presumed ability of the audience, if an application is going to be able to make use of them for descriptions of the audience itself. However, such a description is not really within the scope of BDI.SDD, so there is no semantic recommendation at this writing.
d34 1
a34 1
In 1.0 versions, <nop>AudienceRelationID, which defines the pattern for Audience keys, is defined by restriction from UBIF's <nop>RelationID. However, that must be an integer, whereas we intend(?) to have mnemonic audience keys in BDI.SDD, using some brief strings like en5. XML Spy2004v4 does not enforce this (undesirable) constraint, though Apache does (I think) and so does the embedded parser in Stylus Studio Home Edition
@
1.15
log
@Added topic name via script
@
text
@d1 2
d5 4
a8 6
%META:TOPICINFO{author="GregorHagedorn" date="1146741988" format="1.0" version="1.14"}%
%META:TOPICPARENT{name="ClosedTopicSchemaDiscussionSDD09"}%
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to support applications that recognize more properties of a human user than just language. As of Version 0.62 an <nop>AudienceDefinition object has three required attributes:
* a key by which keyrefs can be used elsewhere to indicate that this <nop>AudienceDefinition is the one referenced
* a lang attribute. It is of type xs:language, which will require it (under validation) to have one of the ISO standard language abbreviations as required by xxxx
* an <nop>ExpertiseLevel The value of this must be one of the integers 1-5 (this constraint is enforced by the schema by declaring a data type <nop>ExpertiseLevelType. That means future changes---hopefully backward compatible---could permit other values simply by changing that type.
d17 1
a17 1
Presumably, the label and description of an audience would be in the language and perhaps presumed ability of the audience, if an application is going to be able to make use of them for descriptions of the audience itself. However, such a description is not really within the scope of SDD, so there is no semantic recommendation at this writing.
d34 1
a34 1
In 1.0 versions, <nop>AudienceRelationID, which defines the pattern for Audience keys, is defined by restriction from UBIF's <nop>RelationID. However, that must be an integer, whereas we intend(?) to have mnemonic audience keys in SDD, using some brief strings like en5. XML Spy2004v4 does not enforce this (undesirable) constraint, though Apache does (I think) and so does the embedded parser in Stylus Studio Home Edition
@
1.14
log
@none
@
text
@d1 2
@
1.13
log
@none
@
text
@d1 2
a2 2
%META:TOPICINFO{author="BobMorris" date="1103336885" format="1.0" version="1.13"}%
%META:TOPICPARENT{name="SchemaDiscussionSDD09"}%
@
1.12
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1103324531" format="1.0" version="1.12"}%
d32 1
a32 1
In 1.0 versions, <nop>AudienceRelationID, which defines the pattern for Audience keys, is defined by restriction from UBIF's RelationID. However, that must be an integer, whereas we intend(?) to have mnemonic audience keys in SDD, using some brief strings like en5. XML Spy2004v4 does not enforce this (undesirable) constraint, though Apache does (I think) and so does the embedded parser in Stylus Studio Home Edition
@
1.11
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1103309517" format="1.0" version="1.11"}%
d27 1
a27 1
In 0.91, <nop>AudienceDefinitions are described in the GeneralDeclarations section and referenced in many places by keyrefs in attributes always of name "audience".
d32 1
a32 1
In 1.0 versions, AudienceRelationID, which defines the pattern for Audience keys, is defined by restriction from UBIF's RelationID. However, that must be an integer, whereas we intend(?) to have mnemonic audience keys in SDD, using some brief strings like en5. XML Spy2004v4 does not enforce this (undesirable) constraint, though Apache does (I think) and so does the embedded parser in Stylus Studio Home Edition
@
1.10
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="GregorHagedorn" date="1087817400" format="1.0" version="1.10"}%
d3 32
a34 27
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to support applications that recognize more properties of a human user than just language. As of Version 0.62 an <nop>AudienceDefinition object has three required attributes:
* a key by which keyrefs can be used elsewhere to indicate that this <nop>AudienceDefinition is the one referenced
* a lang attribute. It is of type xs:language, which will require it (under validation) to have one of the ISO standard language abbreviations as required by xxxx
* an <nop>ExpertiseLevel The value of this must be one of the integers 1-5 (this constraint is enforced by the schema by declaring a data type <nop>ExpertiseLevelType. That means future changes---hopefully backward compatible---could permit other values simply by changing that type.
It is the attributes which most applications will find most useful, because they will use the latter two in tailoring user interfaces. A typical use of Audience references might be in a <nop>CharacterDefinition that has several different text parts, each with a different intended Audience. The application could select the accompanying text based on the Audience.
In addition to those attributes there are two subelements - a label and a description, both strings. 0.62 ascribes no enforceable semantics to these, but the intent is captured by the schemadoc entry:
<verbatim>
<xs:documentation source="G. Hagedorn" xml:lang="en">An audience is a combination of language (including dialect) and expertise (pupil, beginner, expert). Multiple audiences can be defined for the same language and expertise, distinguished only by their label.</xs:documentation>
</verbatim>
Presumably, the label and description of an audience would be in the language and perhaps presumed ability of the audience, if an application is going to be able to make use of them for descriptions of the audience itself. However, such a description is not really within the scope of SDD, so there is no semantic recommendation at this writing.
A documentation element in the 0.62 schema records the committee's design intention for the integers in the <nop>ExpertiseLevel. They are described by this schema doc element on the
<verbatim>
<xs:documentation source="G. Hagedorn" xml:lang="en">ExpertiseLevel is restricted to values from 1-5. These categories allow to communicate expected expertise between different applications using the SDD schema. The recommended interpretation is:
1 = elementary school (year 1 to 6);
2 = middle school (year 7 to 10);
3 = high school (year 11 above) and general public (trying to avoid any specialized terminology or jargon);
4 = university students or (partly) trained personnel (using terminology, but avoiding or explaining problematic terminology);
5 = experts (using the full range of terminology).</xs:documentation>
</verbatim>
In 0.91, <nop>AudienceDefinitions are described in the GeneralDeclarations section and referenced in many places by keyrefs in attributes always of name "audience".
-- Main.BobMorris - 05 Oct 2003/ Gregor Hagedorn 28. May 2004
@
1.9
log
@none
@
text
@d1 2
a2 2
%META:TOPICINFO{author="GregorHagedorn" date="1085765756" format="1.0" version="1.9"}%
%META:TOPICPARENT{name="SchemaDiscussion"}%
@
1.8
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="GregorHagedorn" date="1085757983" format="1.0" version="1.8"}%
d3 2
a4 2
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to support applications that recognize more properties of a human user than just language. As of Version 0.62 an AudienceDefinition object has three required attributes:
* a key by which keyrefs can be used elsewhere to indicate that this AudienceDefinition is the one referenced
d8 1
a8 1
It is the attributes which most applications will find most useful, because they will use the latter two in tailoring user interfaces. A typical use of Audience references might be in a <nop>CharacterDefinition that has several different text parts (the poorly named Trash.TextualDefinitions), each with a different intended Audience. The application could select the accompanying text based on the Audience.
d27 1
a27 1
In 0.62, <nop>AudienceDefinitions are described in the Resource definition section and referenced in many places by keyrefs.
d29 1
a29 1
-- Main.BobMorris - 05 Oct 2003
@
1.7
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="GregorHagedorn" date="1069670280" format="1.0" version="1.7"}%
d8 1
a8 1
It is the attributes which most applications will find most useful, because they will use the latter two in tailoring user interfaces. A typical use of Audience references might be in a <nop>CharacterDefinition that has several different text parts (the poorly named TextualDefinitions), each with a different intended Audience. The application could select the accompanying text based on the Audience.
@
1.6
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1065766264" format="1.0" version="1.6"}%
d6 1
a6 1
* an <nop>ExpertiseLevel The value of this must be one of the integers 1-5 (this constraint is enforced by the schema by declaring a data type ExpertiseLevelType. That means future changes---hopefully backward compatible---could permit other values simply by changing that type.
d27 1
a27 2
In 0.62, <nop>AudienceDefinitions are described in the Resource definition section and referenced in many places by keyrefs. Here is a simple AudienceDefinitionsAndUseExample.
@
1.5
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="KevinThiele" date="1065733155" format="1.0" version="1.5"}%
d3 1
a3 1
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to support applications that recognize more properties of a human user than just language. As of Version 0.62 an AudienceDefinition object has three reqired attributes:
@
1.4
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1065476976" format="1.0" version="1.4"}%
d3 1
a3 1
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to support applications to that recognize more properties of a human user than just language. As of Version 0.62 an AudienceDefinition object has three reqired attributes:
d6 1
a6 1
* an <nop>ExepertiseLevel The value of this must be one of the integers 1-5 (this constraint is enforced by the schema by declaring a data type ExpertiseLevelType. That means future changes---hopefully backward compatible---could permit other values simply by changing that type.
d10 1
a10 1
In addition to those attributes there are two subelements, a label and a description both strings. 0.62 ascribes no enforceable semantics to these, but the intent is captured by the schemadoc entry:
@
1.3
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1065385492" format="1.0" version="1.3"}%
d3 1
a3 1
XML supports the specification of a natural language through use of the "lang" attribute on an element. SDD means to extend this notion to aupport applications to that recognize more properties of a human user than just language. As of Version 0.62 an AudienceDefinition object has three reqired attributes:
@
1.2
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1065380314" format="1.0" version="1.2"}%
d27 2
a28 1
In 0.62, AudienceDefinitions are described in the Resource definition section and referenced in many places by keyrefs.
a29 1
Here's an AudienceDefinitionExample and here's an AudienceUseExample.
@
1.1
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="BobMorris" date="1065373980" format="1.0" version="1.1"}%
d27 3
@