Re: [dita] Unscientific collection of note/@type tallies in IBM content

Collated results, now incorporating Robert's numbers from IBM (and correcting an earlier error for SAP numbers):

SAP

Jeppeson

IXIASOFT

Kris' Client

HPE KM

HPE Simplivity

IBM

TOTAL

note element

287,203

1,200

1,077

595

N/A

N/A

92,926

383,001

@note

135,901

6

33

473

Yes

Yes

1881

138,294

@attention

0

13

3

0

N/A

N/A

906

922

@caution

38,825

6

16

2

Yes

Yes

213

39,062

@danger

0

0

0

0

Yes

No

10

10

@fastpath

0

0

0

0

N/A

N/A

4

4

@important

0

32

87

64

Yes

No

1771

1,954

@notice

0

1

0

N/A

N/A

N/A

13

14

@remember

2,137

2

6

1

N/A

N/A

188

2,334

@restriction

2,384

0

6

0

N/A

N/A

387

2,777

@tip

12,483

73

119

8

Yes

Yes

2214

14,897

@warning

0

9

2

N/A

Yes

Yes

59

70

@trouble

0

0

0

N/A

N/A

N/A

0

0

@other

0

0

0

19

N/A

N/A

15,168

15,187

@-dita-use-conref-target

0

0

0

N/A

N/A

N/A

N/A

0

Here are the numbers for note attributes, from most- to least-used:

@note

138,294

@caution

39,062

@other

15,187

@tip

14,897

@restriction

2,777

@remember

2,334

@important

1,954

@attention

922

@warning

70

@notice

14

@danger

10

@fastpath

4

@trouble

0

@-dita-use-conref-target

0

Cheers!

 

-

Keith Schengili-Roberts

Market Researcher and DITA Evangelist

 

IXIASOFT 

825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1

tel  + 1 514
 279-4942  /  toll free + 1 877 279-4942 

  / 
www.ixiasoft.com

From:  <> on behalf of Robert D Anderson <>

Sent: July 18, 2017 10:39:41 AM

To: DITA

Subject: [dita] Unscientific collection of note/@type tallies in IBM content

 

Big caveat for these numbers -- it comes from a set of over 200,000 topics that I've gotten over the years as test data, so relatively speaking it's just a small sample of IBM DITA content. Much of the data is older (so, no type="trouble",
 which came in with DITA 1.3).

In some cases my test data includes multiple versions of the same content (different releases and/or different languages). For example: across over 200,000 topics I found exactly 4 uses of type="fastpath". One of those was in content delivered
 to customers. The other three were from three different versions of internal education modules for the tools I support.

Interesting data point: for basic notes, authors usually leave off @type, so the biggest use of @type across this data is actually type="other". I have not gone through those values to see what @othertype values are used; from the 10 or 20 I
 scanned in the search results, I saw a lot with othertype="Notes" (also saw "Tips").

With all that in mind:

Total <note> elements: 92,926

Of those:

Untyped (no @type attribute): 70,112

@type=

attention: 906

caution: 213

danger: 10

fastpath: 4

important: 1771

note: 1881

notice: 13

remember: 188

restriction: 387

tip: 2214

trouble: 0

warning: 59

other: 15,168

Regards,

Robert D. Anderson 

DITA-OT lead and Co-editor
DITA 1.3 specification,

Digital Services Group 

E-mail:


Digital Services Group

11501 BURNET RD,, TX, 78758-3400, AUSTIN, USA