Miscellaneous updates.

For Doc Devel Guide:
- Clarify first build documentation
- Add documententation how to publish
- AWT exception workaround for users
- Clarify which document tags need updating for new docs
- Expand description of how to get started
- Minor updates to reference to document directory from "template/" to "doc_dev_guide/"

For project:
- Add new document template (doc_template) for creating new specifications
- Add new document template for create errata (WG Notes)
- Rename the template/ directory to doc_devel_guide/
- Update README for new content and contact people

Signed-off-by: Jeff Scheel <scheel@us.ibm.com>
Jeff Scheel 6 years ago
parent 9600462da2
commit b8e39d5d14

@ -1,7 +1,7 @@
# OpenPOWER Foundation Documentation Development Guide
This repository holds the source for the documentation development guide
This repository holds the source for the *Documentation Development Guide*
(formerly *Master Template Document*) for
OpenPOWER Foundation. The PDF and HTML generated from the doc/template/
OpenPOWER Foundation. The PDF and HTML generated from the ``doc_dev_guide``
directory build a document that both describes how to build a new
document and contains examples and directions on how to do it.

@ -33,8 +33,11 @@ Document library at [OpenPOWER Foundation Documentation Development Guide](http:
The project which controls the look and feel of the document is the
[Docs-Maven-Plugin project](https://github.com/OpenPOWERFoundation/Docs-Maven-Plugin), an
OpenPOWER Foundation private project on GitHub. To obtain access to the Maven Plugin project,
contact Jeff Scheel \([scheel@us.ibm.com](mailto://scheel@us.ibm.com)\) or
Jeff Brown \([jeffdb@us.ibm.com](mailto://jeffdb@us.ibm.com)\).
contact Jeff Scheel \([scheel@us.ibm.com](mailto://scheel@us.ibm.com)\).

Additional sub-directories of interest in this project are:
- ``doc_template``: provides a template for new specifications from scratch
- ``errata_template``: provide a template for errata documents

## License
This project is licensed under the Apache V2 license. More information

@ -54,7 +54,7 @@
<holder>OpenPOWER Foundation</holder>
</copyright>
<!-- TODO: Set the correct document releaseinfo -->
<releaseinfo>Revision 1.2_pre1</releaseinfo>
<releaseinfo>Revision 1.2_pre5</releaseinfo>
<productname>OpenPOWER</productname>
<pubdate/>

@ -91,16 +91,28 @@
<revhistory>
<!-- TODO: Set the initial version information and clear any old information out -->
<revision>
<date>2018-04-07</date>
<date>2018-08-27</date>
<revdescription>
<para>Version 1.2 updates:
<itemizedlist spacing="compact">
<listitem>
<para>Extend the Getting Started section to include a first document build.</para>
</listitem>
<listitem>
<listitem>
<para>Add a section on document packaging for publish in the Publishing OpenPOWER Documents section.</para>
</listitem>
<listitem>
<para>Add a section on circumventing Java AWT exception.</para>
</listitem>
<listitem>
<para>Add information on key document tags which need update for new documents.</para>
</listitem>
<listitem>
<para>Extend information on modifying an existing document to include a step-by-step description of how to get started.</para>
</listitem>
<listitem>
<para>Rename the <literal>template</literal> directory to <literal>doc_dev_guide</literal>.</para>
</listitem>
</itemizedlist></para>
</revdescription>
</revision>

Before

Width:  |  Height:  |  Size: 648 KiB

After

Width:  |  Height:  |  Size: 648 KiB

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>

<svg version="1.2" baseProfile="tiny" width="152.4mm" height="152.4mm" viewBox="0 0 15240 15240" preserveAspectRatio="xMidYMid" fill-rule="evenodd" clip-path="url(#presentation_clip_path)" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg version="1.2" width="152.4mm" height="152.4mm" viewBox="0 0 15240 15240" preserveAspectRatio="xMidYMid" fill-rule="evenodd" stroke-width="28.222" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" xmlns:ooo="http://xml.openoffice.org/svg/export" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:presentation="http://sun.com/xmlns/staroffice/presentation" xmlns:smil="http://www.w3.org/2001/SMIL20/" xmlns:anim="urn:oasis:names:tc:opendocument:xmlns:animation:1.0" xml:space="preserve">
<defs class="ClipPathGroup">
<clipPath id="presentation_clip_path" clipPathUnits="userSpaceOnUse">
<rect x="0" y="0" width="15240" height="15240"/>
@ -8,10 +8,11 @@
</defs>
<defs>
<font id="EmbeddedFont_1" horiz-adv-x="2048">
<font-face font-family="Cousine embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1720" descent="635"/>
<font-face font-family="Cousine embedded" units-per-em="2048" font-weight="normal" font-style="normal" ascent="1693" descent="609"/>
<missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
<glyph unicode="y" horiz-adv-x="1112" d="M 292,-425 C 243,-425 201,-421 168,-414 L 168,-279 C 193,-283 221,-285 252,-285 305,-285 354,-265 401,-226 447,-187 486,-124 518,-38 L 536,11 66,1082 258,1082 522,440 C 583,291 615,206 620,186 L 661,296 971,1082 1161,1082 705,0 C 646,-157 584,-267 521,-330 457,-393 381,-425 292,-425 Z"/>
<glyph unicode="x" horiz-adv-x="1060" d="M 932,0 L 611,444 288,0 94,0 509,556 112,1082 311,1082 611,661 909,1082 1110,1082 713,558 1133,0 932,0 Z"/>
<glyph unicode="v" horiz-adv-x="1112" d="M 715,0 L 502,0 69,1082 271,1082 539,378 556,325 608,141 643,258 682,376 958,1082 1159,1082 715,0 Z"/>
<glyph unicode="u" horiz-adv-x="900" d="M 365,1082 L 365,396 C 365,292 381,220 414,180 447,139 505,119 589,119 675,119 743,148 793,207 843,266 868,348 868,455 L 868,1082 1049,1082 1049,231 C 1049,105 1051,28 1055,0 L 885,0 C 884,3 884,12 883,27 882,42 882,59 881,78 880,97 878,132 877,185 L 874,185 C 833,110 785,58 731,27 676,-4 609,-20 528,-20 409,-20 323,10 268,69 213,128 185,225 185,361 L 185,1082 365,1082 Z"/>
<glyph unicode="t" horiz-adv-x="848" d="M 190,940 L 190,1082 360,1082 418,1364 538,1364 538,1082 970,1082 970,940 538,940 538,288 C 538,235 552,196 581,171 609,146 655,133 720,133 809,133 908,144 1017,167 L 1017,30 C 904,-1 793,-16 682,-16 574,-16 493,7 439,53 385,98 358,170 358,269 L 358,940 190,940 Z"/>
<glyph unicode="s" horiz-adv-x="900" d="M 1060,309 C 1060,206 1021,126 944,68 866,9 758,-20 621,-20 484,-20 379,2 308,45 236,88 189,155 167,248 L 326,279 C 339,222 366,180 408,154 449,127 520,114 621,114 801,114 891,171 891,285 891,328 875,362 842,389 809,415 759,436 692,453 516,496 404,530 357,555 310,580 273,611 248,648 223,685 210,731 210,786 210,884 245,961 316,1016 387,1071 489,1099 623,1099 740,1099 834,1077 904,1033 974,988 1018,924 1035,839 L 873,819 C 866,867 842,903 802,928 762,953 702,965 623,965 460,965 378,915 378,814 378,774 392,742 420,718 447,694 492,675 553,660 L 672,629 C 781,602 859,576 907,550 954,524 992,492 1019,453 1046,414 1060,366 1060,309 Z"/>
@ -25,11 +26,12 @@
<glyph unicode="j" horiz-adv-x="742" d="M 836,-28 C 836,-153 799,-250 724,-320 649,-390 543,-425 405,-425 352,-425 299,-421 244,-412 189,-403 147,-393 117,-382 L 117,-242 C 217,-265 308,-276 390,-276 475,-276 541,-254 587,-210 633,-166 656,-104 656,-25 L 656,940 249,940 249,1082 836,1082 836,-28 Z M 636,1292 L 636,1484 836,1484 836,1292 636,1292 Z"/>
<glyph unicode="i" horiz-adv-x="1007" d="M 745,142 L 1125,142 1125,0 143,0 143,142 565,142 565,940 246,940 246,1082 745,1082 745,142 Z M 545,1292 L 545,1484 745,1484 745,1292 545,1292 Z"/>
<glyph unicode="h" horiz-adv-x="900" d="M 185,1484 L 366,1484 366,1094 C 366,1055 363,989 357,897 L 360,897 C 430,1034 543,1102 699,1102 932,1102 1049,975 1049,721 L 1049,0 868,0 868,695 C 868,786 851,853 816,897 781,941 725,963 648,963 565,963 498,933 445,873 392,812 365,730 365,627 L 365,0 185,0 185,1484 Z"/>
<glyph unicode="f" horiz-adv-x="980" d="M 580,940 L 580,0 400,0 400,940 138,940 138,1082 400,1082 400,1107 C 400,1244 432,1341 497,1398 561,1455 668,1484 818,1484 866,1484 918,1482 974,1478 1029,1473 1071,1468 1099,1463 L 1099,1318 C 1079,1325 1039,1329 978,1329 917,1329 870,1329 839,1329 770,1329 717,1322 682,1307 647,1292 621,1267 605,1233 588,1199 580,1152 580,1092 L 580,1082 1071,1082 1071,940 580,940 Z"/>
<glyph unicode="g" horiz-adv-x="927" d="M 615,-424 C 503,-424 413,-401 345,-355 277,-309 234,-243 215,-157 L 399,-132 C 410,-182 435,-220 473,-248 510,-274 560,-288 621,-288 786,-288 869,-183 869,27 L 869,221 867,221 C 834,152 789,100 731,65 673,30 604,12 524,12 392,12 296,55 235,142 174,228 143,364 143,549 143,738 176,877 241,966 306,1055 407,1099 543,1099 618,1099 684,1082 740,1047 795,1012 838,962 868,897 L 871,897 C 871,918 872,953 875,1002 878,1051 880,1076 883,1076 L 1054,1076 C 1050,1040 1048,966 1048,853 L 1048,30 C 1048,-121 1013,-234 942,-310 871,-386 762,-424 615,-424 Z M 869,551 C 869,680 844,781 794,855 744,928 675,965 588,965 497,965 431,933 390,870 349,806 329,700 329,551 329,450 338,371 355,313 372,254 398,212 434,185 470,158 520,145 585,145 642,145 692,161 735,193 778,224 811,271 834,332 857,393 869,466 869,551 Z"/>
<glyph unicode="f" horiz-adv-x="980" d="M 580,940 L 580,0 400,0 400,940 138,940 138,1082 400,1082 400,1107 C 400,1244 432,1341 497,1398 561,1455 668,1484 818,1484 866,1484 918,1482 974,1478 1029,1473 1071,1468 1099,1463 L 1099,1318 C 1079,1325 1039,1329 978,1329 917,1329 870,1329 839,1329 770,1329 717,1321 682,1306 647,1291 621,1266 605,1231 588,1197 580,1149 580,1087 L 580,1087 1071,1087 1071,940 580,940 Z"/>
<glyph unicode="e" horiz-adv-x="980" d="M 322,503 C 322,382 349,287 403,218 456,149 530,115 623,115 692,115 752,130 804,160 855,189 890,230 907,281 L 1065,236 C 1036,153 982,90 904,46 825,2 732,-20 623,-20 466,-20 345,29 260,127 175,225 133,365 133,548 133,726 175,863 258,959 341,1054 460,1102 617,1102 774,1102 892,1054 973,959 1054,864 1094,720 1094,527 L 1094,503 322,503 Z M 619,969 C 530,969 459,940 407,882 355,823 327,743 324,641 L 908,641 C 889,860 793,969 619,969 Z"/>
<glyph unicode="d" horiz-adv-x="927" d="M 862,174 C 829,104 786,53 732,22 678,-10 611,-26 530,-26 395,-26 296,20 233,113 170,206 138,345 138,532 138,909 269,1098 530,1098 611,1098 678,1084 733,1055 787,1026 830,979 863,914 L 865,914 863,1065 863,1484 1043,1484 1043,223 C 1043,110 1045,36 1049,0 L 877,0 C 874,10 872,34 870,73 868,112 867,145 867,174 L 862,174 Z M 324,538 C 324,390 344,282 384,215 423,147 488,113 577,113 674,113 746,148 793,219 840,289 863,401 863,554 863,697 841,802 796,867 751,932 678,965 579,965 489,965 424,931 384,862 344,793 324,685 324,538 Z"/>
<glyph unicode="c" horiz-adv-x="980" d="M 130,542 C 130,722 173,860 259,957 345,1054 469,1102 632,1102 753,1102 853,1073 932,1015 1011,956 1059,878 1078,779 L 886,765 C 875,826 849,874 806,909 763,944 703,961 624,961 519,961 442,928 393,863 344,798 319,692 319,546 319,398 344,290 393,222 442,153 518,119 623,119 695,119 755,136 802,171 849,205 879,257 890,328 L 1080,328 C 1071,263 1047,204 1008,150 968,97 915,55 850,25 785,-5 712,-20 631,-20 468,-20 343,28 258,124 173,220 130,359 130,542 Z"/>
<glyph unicode="b" horiz-adv-x="927" d="M 1090,546 C 1090,357 1056,215 989,121 921,27 824,-20 698,-20 535,-20 424,41 364,164 L 362,164 C 362,132 361,99 359,64 356,29 354,8 353,0 L 179,0 C 183,36 185,110 185,223 L 185,1484 365,1484 365,1061 C 365,1018 364,965 361,904 L 365,904 C 426,1037 537,1104 699,1104 960,1104 1090,918 1090,546 Z M 904,540 C 904,689 884,798 843,865 802,932 737,965 650,965 551,965 478,929 433,856 388,783 365,672 365,524 365,385 387,281 431,214 475,147 547,113 648,113 738,113 803,148 844,218 884,287 904,395 904,540 Z"/>
<glyph unicode="b" horiz-adv-x="927" d="M 1090,546 C 1090,357 1056,215 989,121 921,27 824,-20 698,-20 535,-20 424,41 364,164 L 362,164 C 362,131 361,96 359,60 356,24 354,6 353,6 L 179,6 C 183,42 185,116 185,228 L 185,1484 365,1484 365,1061 C 365,1018 364,965 361,904 L 365,904 C 426,1037 537,1104 699,1104 960,1104 1090,918 1090,546 Z M 904,540 C 904,689 884,798 843,865 802,932 737,965 650,965 551,965 478,929 433,856 388,783 365,672 365,524 365,385 387,281 431,214 475,147 547,113 648,113 738,113 803,148 844,218 884,287 904,395 904,540 Z"/>
<glyph unicode="a" horiz-adv-x="1059" d="M 1101,111 C 1118,111 1138,113 1160,118 L 1160,6 C 1115,-5 1068,-10 1021,-10 954,-10 906,8 876,43 845,78 828,132 824,207 L 818,207 C 775,126 724,68 665,33 606,-2 533,-20 446,-20 341,-20 261,9 208,67 155,124 128,203 128,304 128,538 279,655 582,655 L 818,655 818,715 C 818,804 800,868 765,907 730,946 673,965 596,965 517,965 461,951 426,923 391,895 371,852 364,793 L 176,810 C 207,1005 348,1102 599,1102 732,1102 833,1071 900,1009 967,946 1000,856 1000,738 L 1000,272 C 1000,219 1007,179 1021,152 1035,125 1062,111 1101,111 Z M 492,117 C 556,117 613,132 662,163 711,193 750,234 777,285 804,336 818,388 818,443 L 818,531 628,531 C 549,531 489,523 448,507 407,491 375,466 352,433 329,400 317,355 317,300 317,245 332,201 362,167 391,134 435,117 492,117 Z"/>
<glyph unicode="_" horiz-adv-x="1271" d="M -5,-220 L -5,-124 1233,-124 1233,-220 -5,-220 Z"/>
<glyph unicode="T" horiz-adv-x="1112" d="M 709,1193 L 709,0 519,0 519,1193 76,1193 76,1349 1152,1349 1152,1193 709,1193 Z"/>
@ -44,30 +46,30 @@
</defs>
<defs>
<font id="EmbeddedFont_2" horiz-adv-x="2048">
<font-face font-family="Cousine embedded" units-per-em="2048" font-weight="normal" font-style="italic" ascent="1720" descent="635"/>
<font-face font-family="Cousine embedded" units-per-em="2048" font-weight="normal" font-style="italic" ascent="1693" descent="609"/>
<missing-glyph horiz-adv-x="2048" d="M 0,0 L 2047,0 2047,2047 0,2047 0,0 Z"/>
<glyph unicode="”" horiz-adv-x="1007" d="M 680,862 L 969,1484 1234,1484 803,862 680,862 Z M 241,862 L 530,1484 795,1484 364,862 241,862 Z"/>
<glyph unicode="“" horiz-adv-x="1007" d="M 794,1484 L 505,862 240,862 671,1484 794,1484 Z M 1233,1484 L 944,862 679,862 1110,1484 1233,1484 Z"/>
<glyph unicode="w" horiz-adv-x="1245" d="M 913,0 L 709,0 658,471 640,673 574,534 302,0 99,0 126,1082 304,1082 279,475 C 278,437 274,379 267,301 260,222 254,172 249,149 L 288,235 349,363 566,787 759,787 806,362 820,149 C 823,166 829,188 836,213 843,238 871,326 918,475 L 1137,1082 1313,1082 913,0 Z"/>
<glyph unicode="u" horiz-adv-x="1033" d="M 470,1082 L 337,396 C 328,348 323,307 323,273 323,217 337,177 366,154 394,131 441,119 507,119 594,119 669,149 730,209 791,269 832,351 851,455 L 973,1082 1154,1082 989,231 C 984,208 980,185 976,160 971,135 967,111 964,89 960,66 957,47 954,31 951,15 950,5 950,0 L 780,0 C 780,7 784,33 791,78 798,122 803,158 808,185 L 805,185 C 750,110 691,58 630,27 568,-4 498,-20 419,-20 322,-20 250,-1 204,38 158,77 135,138 135,223 135,263 140,309 150,361 L 290,1082 470,1082 Z"/>
<glyph unicode="u" horiz-adv-x="1033" d="M 470,1082 L 337,396 C 328,348 323,307 323,273 323,217 337,177 366,154 394,131 441,119 507,119 594,119 669,149 730,209 791,269 832,351 851,455 L 973,1082 1154,1082 989,228 C 984,205 980,181 976,156 971,131 967,107 964,85 960,62 957,43 954,27 951,11 950,3 950,3 L 780,3 C 780,10 784,36 791,79 798,123 803,158 808,185 L 805,185 C 750,110 691,58 630,27 568,-4 498,-20 419,-20 322,-20 250,-1 204,38 158,77 135,138 135,223 135,263 140,309 150,361 L 290,1082 470,1082 Z"/>
<glyph unicode="t" horiz-adv-x="821" d="M 268,940 L 295,1082 465,1082 578,1364 698,1364 643,1082 1075,1082 1048,940 616,940 489,288 484,244 C 484,206 497,178 522,160 547,142 587,133 641,133 730,133 831,144 944,167 L 918,30 C 801,-1 686,-16 574,-16 481,-16 412,1 366,34 320,67 297,118 297,189 297,219 300,246 305,269 L 436,940 268,940 Z"/>
<glyph unicode="s" horiz-adv-x="1006" d="M 512,-20 C 375,-20 275,1 212,44 149,86 115,154 110,248 L 275,279 C 277,220 297,178 334,153 371,127 439,114 538,114 639,114 716,132 767,169 818,206 844,254 844,315 844,348 830,375 803,397 775,419 729,439 666,456 L 550,487 C 462,511 400,533 365,553 329,572 301,596 282,625 262,653 252,687 252,728 252,776 263,824 285,872 307,920 339,961 381,995 422,1029 473,1055 533,1073 593,1090 659,1099 732,1099 849,1099 939,1077 1001,1032 1062,987 1093,923 1093,839 L 927,819 927,824 C 927,871 910,906 875,930 840,953 784,965 706,965 614,965 545,949 498,917 451,885 428,841 428,784 428,753 440,728 464,709 487,689 528,672 585,657 732,618 825,590 864,573 903,556 934,536 957,514 980,491 997,468 1007,445 1016,422 1021,395 1021,366 1021,297 1000,232 958,171 916,109 856,62 779,29 702,-4 613,-20 512,-20 Z"/>
<glyph unicode="r" horiz-adv-x="980" d="M 1118,918 C 1047,931 977,937 910,937 803,937 709,897 627,816 545,735 492,633 468,508 L 369,0 189,0 325,701 C 342,792 350,888 350,990 L 347,1082 518,1082 C 522,1049 524,1006 524,954 524,910 522,869 518,832 L 523,832 C 572,907 615,962 654,997 692,1032 735,1058 782,1076 829,1093 885,1102 948,1102 1019,1102 1086,1096 1151,1085 L 1118,918 Z"/>
<glyph unicode="p" horiz-adv-x="1138" d="M 589,-20 C 424,-20 326,41 294,164 L 289,164 C 289,157 286,139 281,108 276,77 241,-100 178,-425 L -3,-425 247,858 C 265,949 277,1023 284,1082 L 459,1082 C 459,1069 456,1041 450,999 444,956 439,925 435,904 L 439,904 C 486,974 538,1025 597,1057 655,1088 725,1104 808,1104 1013,1104 1116,992 1116,768 1116,705 1108,631 1091,546 1018,169 850,-20 589,-20 Z M 928,743 C 928,815 913,870 884,908 854,946 804,965 734,965 669,965 615,951 570,923 525,894 486,851 453,792 420,733 393,659 373,572 353,484 343,410 343,350 343,269 361,210 397,171 433,132 489,113 566,113 644,113 709,139 760,191 811,243 851,327 882,444 913,561 928,660 928,743 Z"/>
<glyph unicode="o" horiz-adv-x="1006" d="M 500,-20 C 375,-20 279,13 212,79 145,144 112,240 112,367 112,420 118,478 130,542 167,728 236,868 339,962 441,1055 569,1102 724,1102 857,1102 955,1071 1020,1010 1085,949 1117,856 1117,732 1117,642 1103,547 1075,448 1047,348 1006,263 952,192 898,121 833,68 756,33 679,-2 594,-20 500,-20 Z M 928,720 C 928,803 910,866 874,907 837,948 780,969 701,969 613,969 540,943 483,892 425,841 380,764 349,662 317,560 301,464 301,373 301,200 375,113 524,113 591,113 649,127 696,155 743,182 784,225 819,283 853,341 880,413 899,499 918,584 928,658 928,720 Z"/>
<glyph unicode="n" horiz-adv-x="1033" d="M 763,0 L 898,695 C 905,734 909,766 909,793 909,852 895,895 866,922 837,949 791,963 730,963 647,963 574,933 510,873 445,812 403,730 382,627 L 260,0 80,0 245,851 C 250,874 254,898 259,923 263,948 267,971 271,994 274,1016 277,1035 280,1051 283,1067 284,1077 284,1082 L 454,1082 C 454,1078 451,1056 446,1015 440,974 433,934 426,897 L 429,897 C 474,960 528,1010 590,1047 652,1084 727,1102 815,1102 1004,1102 1098,1017 1098,848 1098,810 1093,768 1084,721 L 944,0 763,0 Z"/>
<glyph unicode="m" horiz-adv-x="1192" d="M 426,0 L 559,686 C 574,759 581,816 581,857 581,896 574,924 561,940 548,955 527,963 499,963 457,963 417,932 378,869 339,806 309,719 287,607 L 169,0 0,0 165,851 C 170,874 174,898 179,923 183,948 187,971 191,994 194,1016 197,1035 200,1051 203,1067 204,1077 204,1082 L 353,1082 334,955 325,907 327,907 C 365,978 404,1029 445,1058 486,1087 531,1102 581,1102 640,1102 680,1086 703,1055 726,1023 737,975 737,912 L 737,906 739,906 C 780,977 822,1027 865,1057 908,1087 957,1102 1013,1102 1072,1102 1114,1087 1141,1056 1168,1025 1181,977 1181,910 1181,860 1174,797 1159,721 L 1019,0 851,0 984,686 C 999,759 1006,816 1006,857 1006,896 999,924 986,940 973,955 952,963 924,963 881,963 841,935 804,879 767,822 737,738 716,627 L 594,0 426,0 Z"/>
<glyph unicode="n" horiz-adv-x="1033" d="M 763,0 L 898,695 C 905,734 909,766 909,793 909,852 895,895 866,922 837,949 791,963 730,963 647,963 574,933 510,873 445,812 403,730 382,627 L 260,0 80,0 245,853 C 250,876 254,900 259,925 263,950 267,974 271,996 274,1019 277,1038 280,1054 283,1070 284,1078 284,1078 L 454,1078 C 454,1074 451,1052 446,1012 440,972 433,934 426,897 L 429,897 C 474,960 528,1010 590,1047 652,1084 727,1102 815,1102 1004,1102 1098,1017 1098,848 1098,810 1093,768 1084,721 L 944,0 763,0 Z"/>
<glyph unicode="m" horiz-adv-x="1192" d="M 426,0 L 559,686 C 574,759 581,816 581,857 581,896 574,924 561,940 548,955 527,963 499,963 457,963 417,932 378,869 339,806 309,719 287,607 L 169,0 0,0 165,853 C 170,876 174,900 179,925 183,950 187,974 191,996 194,1019 197,1038 200,1054 203,1070 204,1078 204,1078 L 353,1078 334,954 325,907 327,907 C 365,978 404,1029 445,1058 486,1087 531,1102 581,1102 640,1102 680,1086 703,1055 726,1023 737,975 737,912 L 737,906 739,906 C 780,977 822,1027 865,1057 908,1087 957,1102 1013,1102 1072,1102 1114,1087 1141,1056 1168,1025 1181,977 1181,910 1181,860 1174,797 1159,721 L 1019,0 851,0 984,686 C 999,759 1006,816 1006,857 1006,896 999,924 986,940 973,955 952,963 924,963 881,963 841,935 804,879 767,822 737,738 716,627 L 594,0 426,0 Z"/>
<glyph unicode="l" horiz-adv-x="1033" d="M 659,142 L 1039,142 1011,0 29,0 57,142 479,142 712,1342 423,1342 450,1484 919,1484 659,142 Z"/>
<glyph unicode="k" horiz-adv-x="1112" d="M 809,0 L 540,499 389,401 311,0 131,0 419,1484 599,1484 419,557 996,1082 1207,1082 678,617 1020,0 809,0 Z"/>
<glyph unicode="j" horiz-adv-x="1112" d="M 217,-425 C 164,-425 112,-421 60,-412 7,-403 -33,-393 -62,-382 L -35,-242 C 60,-265 149,-276 231,-276 316,-276 385,-254 440,-211 495,-167 530,-105 546,-25 L 734,940 327,940 354,1082 941,1082 726,-28 C 702,-152 646,-249 557,-320 468,-390 355,-425 217,-425 Z M 782,1292 L 819,1484 1019,1484 982,1292 782,1292 Z"/>
<glyph unicode="i" horiz-adv-x="1033" d="M 668,142 L 1048,142 1020,0 38,0 66,142 488,142 643,940 324,940 351,1082 850,1082 668,142 Z M 691,1292 L 728,1484 928,1484 891,1292 691,1292 Z"/>
<glyph unicode="h" horiz-adv-x="1033" d="M 368,1484 L 549,1484 474,1094 C 467,1057 451,991 426,897 L 429,897 C 474,960 527,1010 588,1047 649,1084 722,1102 808,1102 1001,1102 1097,1016 1097,843 1097,805 1093,764 1084,721 L 944,0 763,0 898,695 C 905,734 909,766 909,793 909,852 895,895 866,922 837,949 791,963 730,963 647,963 574,933 510,873 445,812 403,730 382,627 L 260,0 80,0 368,1484 Z"/>
<glyph unicode="g" horiz-adv-x="1112" d="M 428,-424 C 315,-424 230,-401 171,-355 112,-309 82,-243 79,-157 L 268,-132 C 269,-182 286,-220 319,-248 352,-274 399,-288 460,-288 627,-288 730,-183 769,27 L 807,221 805,221 C 711,82 583,12 421,12 317,12 241,38 193,91 144,143 120,222 120,328 120,411 133,508 160,620 187,731 222,822 266,891 310,960 364,1012 428,1047 491,1082 566,1099 652,1099 727,1099 789,1082 838,1047 887,1012 920,962 937,897 L 940,897 C 945,922 953,957 965,1004 977,1050 985,1076 988,1082 L 1159,1082 1140,1000 1110,858 949,32 C 920,-119 862,-233 777,-310 692,-386 575,-424 428,-424 Z M 887,697 C 887,781 868,847 831,894 793,941 740,965 671,965 611,965 560,952 518,926 476,900 440,859 411,804 382,749 357,675 338,584 318,492 308,416 308,355 308,282 324,228 355,195 386,162 437,145 508,145 561,145 612,159 659,188 706,217 746,258 781,312 816,365 842,428 860,501 878,573 887,638 887,697 Z"/>
<glyph unicode="f" horiz-adv-x="1085" d="M 658,940 L 475,0 295,0 478,940 216,940 243,1082 505,1082 510,1107 C 537,1243 588,1340 663,1398 738,1455 850,1484 1001,1484 1048,1484 1098,1482 1153,1478 1208,1473 1249,1468 1278,1463 L 1250,1324 C 1231,1327 1190,1329 1129,1329 1068,1329 1022,1329 993,1329 923,1329 869,1322 831,1307 793,1292 763,1267 740,1233 717,1199 698,1148 685,1082 L 1176,1082 1149,940 658,940 Z"/>
<glyph unicode="g" horiz-adv-x="1112" d="M 428,-424 C 315,-424 230,-401 171,-355 112,-309 82,-243 79,-157 L 268,-132 C 269,-182 286,-220 319,-248 352,-274 399,-288 460,-288 627,-288 730,-183 769,27 L 807,221 805,221 C 711,82 583,12 421,12 317,12 241,38 193,91 144,143 120,222 120,328 120,411 133,508 160,620 187,731 222,822 266,891 310,960 364,1012 428,1047 491,1082 566,1099 652,1099 727,1099 789,1082 838,1047 887,1012 920,962 937,897 L 940,897 C 945,922 953,959 965,1006 977,1053 985,1077 988,1077 L 1159,1077 1140,995 1110,854 949,30 C 920,-120 862,-234 777,-310 692,-386 575,-424 428,-424 Z M 887,697 C 887,781 868,847 831,894 793,941 740,965 671,965 611,965 560,952 518,926 476,900 440,859 411,804 382,749 357,675 338,584 318,492 308,416 308,355 308,282 324,228 355,195 386,162 437,145 508,145 561,145 612,159 659,188 706,217 746,258 781,312 816,365 842,428 860,501 878,573 887,638 887,697 Z"/>
<glyph unicode="f" horiz-adv-x="1085" d="M 658,940 L 475,0 295,0 478,940 216,940 243,1082 505,1082 510,1107 C 537,1243 588,1340 663,1398 738,1455 850,1484 1001,1484 1048,1484 1098,1482 1153,1478 1208,1473 1249,1468 1278,1463 L 1250,1318 C 1231,1325 1190,1329 1129,1329 1068,1329 1022,1329 993,1329 923,1329 869,1322 831,1307 793,1292 763,1267 740,1233 717,1199 698,1148 685,1082 L 1176,1082 1149,940 658,940 Z"/>
<glyph unicode="e" horiz-adv-x="1006" d="M 315,503 C 306,457 302,417 302,382 302,296 323,230 365,184 406,138 465,115 540,115 608,115 671,130 729,159 786,188 829,229 857,281 L 1006,236 C 960,153 894,90 808,46 721,2 623,-20 514,-20 385,-20 286,14 218,81 150,148 116,244 116,370 116,453 129,542 156,639 183,735 223,818 276,889 329,959 394,1012 469,1048 544,1084 630,1102 726,1102 983,1102 1112,976 1112,723 1112,662 1105,597 1091,527 L 1087,503 315,503 Z M 702,969 C 613,969 538,940 475,882 412,824 368,744 344,641 L 928,641 932,713 C 932,884 855,969 702,969 Z"/>
<glyph unicode="d" horiz-adv-x="1139" d="M 791,174 C 745,104 692,53 632,22 571,-10 501,-26 420,-26 315,-26 237,2 187,58 137,113 112,198 112,311 112,376 120,449 136,532 210,909 377,1098 638,1098 719,1098 784,1084 833,1055 882,1026 916,979 936,914 L 938,914 959,1034 1046,1484 1226,1484 981,223 C 960,104 947,29 944,0 L 772,0 772,4 C 772,33 780,89 796,174 L 791,174 Z M 301,337 C 301,259 317,202 348,167 379,131 427,113 494,113 579,113 649,139 705,192 760,245 804,326 837,437 870,547 886,644 886,728 886,809 868,868 832,907 796,946 739,965 662,965 604,965 554,952 513,925 472,898 436,855 407,798 377,741 352,666 332,573 311,480 301,402 301,337 Z"/>
<glyph unicode="c" horiz-adv-x="1033" d="M 741,1102 C 862,1102 956,1073 1023,1016 1090,958 1124,879 1124,779 L 930,765 930,771 C 930,828 912,874 877,909 842,944 785,961 706,961 617,961 543,938 485,891 427,844 382,768 350,665 317,562 301,464 301,372 301,285 321,221 361,180 401,139 461,119 541,119 613,119 676,136 731,171 785,205 825,257 850,328 L 1038,328 C 1017,263 981,204 932,150 882,97 822,55 751,25 680,-5 603,-20 522,-20 387,-20 285,13 216,79 147,145 112,242 112,369 112,454 126,544 154,640 181,735 223,818 278,889 333,960 399,1013 477,1049 554,1084 642,1102 741,1102 Z"/>
<glyph unicode="b" horiz-adv-x="1059" d="M 589,-20 C 426,-20 327,41 291,164 L 289,164 C 284,135 276,101 266,64 256,26 250,5 248,0 L 74,0 C 77,10 84,37 94,82 103,127 113,174 123,223 L 368,1484 548,1484 466,1061 432,904 436,904 C 523,1037 647,1104 809,1104 1013,1104 1115,990 1115,761 1115,699 1107,627 1091,546 1054,357 993,215 907,121 821,27 715,-20 589,-20 Z M 926,736 C 926,816 910,874 879,911 847,947 798,965 733,965 649,965 579,939 523,886 467,833 423,753 391,645 359,536 343,438 343,351 343,269 361,209 397,171 433,132 489,113 565,113 645,113 711,140 762,195 813,249 853,332 882,443 911,554 926,651 926,736 Z"/>
<glyph unicode="b" horiz-adv-x="1059" d="M 589,-20 C 426,-20 327,41 291,164 L 289,164 C 284,134 276,100 266,61 256,22 250,3 248,3 L 74,3 C 77,13 84,40 94,85 103,129 113,176 123,226 L 368,1484 548,1484 466,1061 432,904 436,904 C 523,1037 647,1104 809,1104 1013,1104 1115,990 1115,761 1115,699 1107,627 1091,546 1054,357 993,215 907,121 821,27 715,-20 589,-20 Z M 926,736 C 926,816 910,874 879,911 847,947 798,965 733,965 649,965 579,939 523,886 467,833 423,753 391,645 359,536 343,438 343,351 343,269 361,209 397,171 433,132 489,113 565,113 645,113 711,140 762,195 813,249 853,332 882,443 911,554 926,651 926,736 Z"/>
<glyph unicode="a" horiz-adv-x="1033" d="M 1018,111 C 1036,111 1056,113 1078,118 L 1056,6 C 1009,-5 962,-10 914,-10 856,-10 815,3 791,28 766,53 754,91 754,142 L 759,207 753,207 C 694,126 631,68 565,33 498,-2 422,-20 337,-20 248,-20 182,1 139,42 95,84 73,141 73,214 73,242 76,272 82,304 127,538 302,655 605,655 L 841,655 C 852,710 859,745 861,759 862,774 863,789 863,805 863,863 848,904 817,928 786,953 740,965 679,965 602,965 543,952 504,926 464,899 434,855 413,793 L 228,810 C 264,909 322,983 401,1031 480,1078 582,1102 708,1102 935,1102 1048,1013 1048,835 1048,805 1045,773 1038,738 L 948,272 C 942,243 939,218 939,196 939,168 945,147 957,133 969,118 989,111 1018,111 Z M 410,117 C 473,117 533,132 588,162 643,192 690,233 727,284 764,335 788,388 799,443 L 817,531 626,531 C 536,531 466,520 417,497 367,475 329,441 304,397 278,352 265,304 265,252 265,210 277,177 302,153 326,129 362,117 410,117 Z"/>
<glyph unicode="W" horiz-adv-x="1324" d="M 913,0 L 705,0 673,432 C 670,471 665,579 658,756 636,703 609,639 576,565 543,490 455,302 314,0 L 106,0 157,1349 346,1349 293,514 C 284,404 273,289 259,168 314,298 358,400 392,475 425,550 496,702 604,931 L 779,931 C 794,746 805,605 813,506 820,407 825,294 828,168 L 930,514 1196,1349 1385,1349 913,0 Z"/>
<glyph unicode="T" horiz-adv-x="1139" d="M 836,1193 L 604,0 414,0 646,1193 203,1193 233,1349 1309,1349 1279,1193 836,1193 Z"/>
@ -126,322 +128,386 @@
<g class="Page">
<g class="com.sun.star.drawing.TextShape">
<g id="id3">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="1223" y="1129"><tspan fill="rgb(0,0,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="973" y="708" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="1223" y="1125"><tspan fill="rgb(0,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id4">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2524" y="1630"><tspan fill="rgb(0,128,0)" stroke="none">Docs-Master</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="2274" y="1209" width="2831" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2524" y="1626"><tspan fill="rgb(0,128,0)" stroke="none">Docs-Master</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id5">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2524" y="5131"><tspan fill="rgb(0,0,255)" stroke="none">Docs-Template</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="2274" y="4710" width="3255" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2524" y="5127"><tspan fill="rgb(0,0,255)" stroke="none">Docs-Template</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id6">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3624" y="2131"><tspan fill="rgb(0,128,0)" stroke="none">common</tspan><tspan fill="rgb(0,0,0)" stroke="none"> </tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3374" y="1710" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3624" y="2127"><tspan fill="rgb(0,128,0)" stroke="none">common</tspan><tspan fill="rgb(0,0,0)" stroke="none"> </tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id7">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3624" y="4132"><tspan fill="rgb(0,128,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3374" y="3711" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3624" y="4128"><tspan fill="rgb(0,128,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id8">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4724" y="2632"><tspan fill="rgb(0,128,0)" stroke="none">ch_preface.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4474" y="2211" width="3466" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4724" y="2628"><tspan fill="rgb(0,128,0)" stroke="none">ch_preface.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id9">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3569" y="4630"><tspan fill="rgb(0,128,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3319" y="4209" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3569" y="4626"><tspan fill="rgb(0,128,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id10">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4725" y="3133"><tspan fill="rgb(0,128,0)" stroke="none">app_foundation.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4475" y="2712" width="4313" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4725" y="3129"><tspan fill="rgb(0,128,0)" stroke="none">app_foundation.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id11">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4708" y="3631"><tspan fill="rgb(0,128,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4458" y="3210" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4708" y="3627"><tspan fill="rgb(0,128,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id12">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3625" y="5631"><tspan fill="rgb(0,0,255)" stroke="none">template</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3375" y="5210" width="3255" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3625" y="5627"><tspan fill="rgb(0,0,255)" stroke="none">doc_dev_guide</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id13">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3625" y="7632"><tspan fill="rgb(0,0,255)" stroke="none">pom.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3375" y="7211" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3625" y="7628"><tspan fill="rgb(0,0,255)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id14">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4625" y="6132"><tspan fill="rgb(0,0,255)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4375" y="5711" width="2831" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4625" y="6128"><tspan fill="rgb(0,0,255)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id15">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3589" y="8130"><tspan fill="rgb(0,0,255)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3339" y="7709" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3589" y="8126"><tspan fill="rgb(0,0,255)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id16">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="6633"><tspan fill="rgb(0,0,255)" stroke="none">pom.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4376" y="6212" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="6629"><tspan fill="rgb(0,0,255)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id17">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4590" y="7131"><tspan fill="rgb(0,0,255)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4340" y="6710" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4590" y="7127"><tspan fill="rgb(0,0,255)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id18">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2525" y="8631"><tspan fill="rgb(255,0,0)" stroke="none">my_project</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="2275" y="8210" width="2620" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2525" y="8627"><tspan fill="rgb(255,0,0)" stroke="none">my_project</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id19">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3626" y="9131"><tspan fill="rgb(255,0,0)" stroke="none">my_doc_1</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3376" y="8710" width="2196" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3626" y="9127"><tspan fill="rgb(255,0,0)" stroke="none">my_doc_1</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id20">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3588" y="13132"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3338" y="12711" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3588" y="13128"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id21">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="9632"><tspan fill="rgb(255,0,0)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4376" y="9211" width="2831" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="9628"><tspan fill="rgb(255,0,0)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id22">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3571" y="13630"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3321" y="13209" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3571" y="13626"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id23">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4627" y="10133"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4377" y="9712" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4627" y="10129"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id24">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4591" y="10631"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4341" y="10210" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4591" y="10627"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id25">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3626" y="11132"><tspan fill="rgb(255,0,0)" stroke="none">my_doc_2</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="3376" y="10711" width="2196" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="3626" y="11128"><tspan fill="rgb(255,0,0)" stroke="none">my_doc_2</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id26">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="11633"><tspan fill="rgb(255,0,0)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4376" y="11212" width="2831" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4626" y="11629"><tspan fill="rgb(255,0,0)" stroke="none">bk_main.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id27">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4627" y="12134"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4377" y="11713" width="1985" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4627" y="12130"><tspan fill="rgb(255,0,0)" stroke="none">pom.xml</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id28">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4591" y="12632"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="4341" y="12211" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="4591" y="12628"><tspan fill="rgb(255,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id29">
<rect class="BoundingBox" stroke="none" fill="none" x="1540" y="1360" width="736" height="177"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,1361 L 1541,1535 2274,1535"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id30">
<rect class="BoundingBox" stroke="none" fill="none" x="1540" y="1360" width="736" height="3678"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,1361 L 1541,5036 2274,5036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id31">
<rect class="BoundingBox" stroke="none" fill="none" x="1540" y="1360" width="737" height="7178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,1361 L 1541,8536 2275,8536"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id32">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2490" y="14131"><tspan fill="rgb(0,0,0)" stroke="none">...</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="2240" y="13710" width="1138" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-weight="400"><tspan class="TextPosition" x="2490" y="14127"><tspan fill="rgb(0,0,0)" stroke="none">...</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id33">
<rect class="BoundingBox" stroke="none" fill="none" x="1540" y="8535" width="702" height="5503"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 1541,8536 L 1541,14036 2240,14036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id34">
<rect class="BoundingBox" stroke="none" fill="none" x="2777" y="1860" width="599" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2804,1861 L 2778,1861 2778,2036 3374,2036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id35">
<rect class="BoundingBox" stroke="none" fill="none" x="2742" y="1860" width="634" height="2179"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2743,1861 L 2778,1861 2778,4037 3374,4037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id36">
<rect class="BoundingBox" stroke="none" fill="none" x="2743" y="1860" width="578" height="2677"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2744,1861 L 2782,1861 2782,4535 3319,4535"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id37">
<rect class="BoundingBox" stroke="none" fill="none" x="2778" y="5360" width="599" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2805,5361 L 2779,5361 2779,5536 3375,5536"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id38">
<rect class="BoundingBox" stroke="none" fill="none" x="2743" y="5360" width="634" height="2179"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2744,5361 L 2779,5361 2779,7537 3375,7537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id39">
<rect class="BoundingBox" stroke="none" fill="none" x="2744" y="5360" width="578" height="2677"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2745,5361 L 2783,5361 2783,8035 3320,8035"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id40">
<rect class="BoundingBox" stroke="none" fill="none" x="2779" y="8860" width="599" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2806,8861 L 2780,8861 2780,9036 3376,9036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id41">
<rect class="BoundingBox" stroke="none" fill="none" x="2744" y="8860" width="634" height="2179"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2745,8861 L 2780,8861 2780,11037 3376,11037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id42">
<rect class="BoundingBox" stroke="none" fill="none" x="2745" y="8860" width="578" height="4677"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2746,8861 L 2784,8861 2784,13535 3321,13535"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id43">
<rect class="BoundingBox" stroke="none" fill="none" x="2746" y="8860" width="594" height="4179"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 2747,8861 L 2793,8861 2793,13037 3338,13037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id44">
<rect class="BoundingBox" stroke="none" fill="none" x="3903" y="2361" width="573" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3904,2362 L 3939,2362 3939,2537 4474,2537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id45">
<rect class="BoundingBox" stroke="none" fill="none" x="3903" y="2362" width="574" height="678"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3904,2363 L 3940,2363 3940,3038 4475,3038"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id46">
<rect class="BoundingBox" stroke="none" fill="none" x="3904" y="2363" width="556" height="1175"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3905,2364 L 3932,2364 3932,3536 4458,3536"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id47">
<rect class="BoundingBox" stroke="none" fill="none" x="3904" y="5861" width="573" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3905,5862 L 3940,5862 3940,6037 4475,6037"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id48">
<rect class="BoundingBox" stroke="none" fill="none" x="3904" y="5862" width="574" height="678"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3905,5863 L 3941,5863 3941,6538 4476,6538"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id49">
<rect class="BoundingBox" stroke="none" fill="none" x="3905" y="5863" width="556" height="1175"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3906,5864 L 3933,5864 3933,7036 4459,7036"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id50">
<rect class="BoundingBox" stroke="none" fill="none" x="3905" y="9361" width="573" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3906,9362 L 3941,9362 3941,9537 4476,9537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id51">
<rect class="BoundingBox" stroke="none" fill="none" x="3905" y="9362" width="574" height="678"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3906,9363 L 3942,9363 3942,10038 4477,10038"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id52">
<rect class="BoundingBox" stroke="none" fill="none" x="3906" y="9363" width="556" height="1175"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3907,9364 L 3934,9364 3934,10536 4460,10536"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id53">
<rect class="BoundingBox" stroke="none" fill="none" x="3906" y="11361" width="573" height="178"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3907,11362 L 3942,11362 3942,11537 4477,11537"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id54">
<rect class="BoundingBox" stroke="none" fill="none" x="3906" y="11362" width="574" height="678"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3907,11363 L 3943,11363 3943,12038 4478,12038"/>
</g>
</g>
<g class="com.sun.star.drawing.ConnectorShape">
<g id="id55">
<rect class="BoundingBox" stroke="none" fill="none" x="3907" y="11363" width="556" height="1175"/>
<path fill="none" stroke="rgb(52,101,164)" d="M 3908,11364 L 3935,11364 3935,12536 4461,12536"/>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id56">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="8524" y="1631"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master document framework”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="8274" y="1210" width="6218" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="8524" y="1627"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master document framework”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id57">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11276" y="2132"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Common files”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="11026" y="1711" width="3467" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11276" y="2128"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Common files”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id58">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11692" y="4133"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master POM”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="11442" y="3712" width="3043" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11692" y="4129"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master POM”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id59">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="9356" y="5634"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master Template Guide”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="9106" y="5213" width="5372" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="9356" y="5630"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Master Template Guide”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id60">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="10825" y="6135"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Main book file”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="10575" y="5714" width="3890" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="10825" y="6131"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Main book file”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id61">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11267" y="6634"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Document POM”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="11017" y="6213" width="3467" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11267" y="6630"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Document POM”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id62">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11015" y="7635"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Workgroup POM”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="10765" y="7214" width="3678" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11015" y="7631"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Workgroup POM”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id63">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11884" y="8636"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">A project”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="11634" y="8215" width="2832" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11884" y="8632"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">A project”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id64">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11669" y="9137"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">A document”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="11419" y="8716" width="3043" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11669" y="9133"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">A document”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id65">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="10385" y="11138"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Another document”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="10135" y="10717" width="4313" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="10385" y="11134"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Another document”</tspan></tspan></tspan></text>
</g>
</g>
<g class="com.sun.star.drawing.TextShape">
<g id="id66">
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11017" y="13139"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Workgroup POM”</tspan></tspan></tspan></text>
<rect class="BoundingBox" stroke="none" fill="none" x="10767" y="12718" width="3678" height="654"/>
<text class="TextShape"><tspan class="TextParagraph" font-family="Cousine, monospace" font-size="353px" font-style="italic" font-weight="400"><tspan class="TextPosition" x="11017" y="13135"><tspan fill="rgb(0,0,0)" stroke="none">“</tspan><tspan fill="rgb(0,0,0)" stroke="none">Workgroup POM”</tspan></tspan></tspan></text>
</g>
</g>
</g>

Before

Width:  |  Height:  |  Size: 48 KiB

After

Width:  |  Height:  |  Size: 55 KiB

@ -73,7 +73,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_debug">

Note: Open the temporary file:

file:/home/user1/Docs-Template/template/target//bk_main.xml-invalid.xml
file:/home/user1/Docs-Template/doc_dev_guide/target//bk_main.xml-invalid.xml

to see all the errors in context.
You must correct the errors in the original
@ -87,7 +87,7 @@ lineNumber: 272; columnNumber: 70; text not allowed here; expected element "add
<orderedlist>
<listitem>
<para>The full path and filename that contains the context for the failure. In the message above, this is
<literal>/home/user1/Docs-Template/template/target//bk_main.xml-invalid.xml</literal>.</para>
<literal>/home/user1/Docs-Template/doc_dev_guide/target//bk_main.xml-invalid.xml</literal>.</para>
</listitem>
<listitem>
<para>The location within the file of the syntax error. For the above example, the key information is "<literal>lineNumber: 272; columnNumber: 70</literal>.</para>
@ -115,14 +115,14 @@ lineNumber: 272; columnNumber: 70; text not allowed here; expected element "add
[INFO] Finished at: Wed Jul 29 14:55:33 CDT 2015
[INFO] Final Memory: 17M/171M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp (generate-webhelp) on project openpower-template-guide: Execution generate-webhelp of goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp failed: XInclude resource error (sec_template_new_document.xml) and no fallback provided. XProc error err:XD0011: org.xml.sax.SAXParseException; systemId: file:/home/user1/openpower-foundation-docbkx-framework/doc/template/sec_template_new_document.xml; lineNumber: 55; columnNumber: 17; The element type "para" must be terminated by the matching end-tag "&lt;/para&gt;". -> [Help 1]
[ERROR] Failed to execute goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp (generate-webhelp) on project openpower-template-guide: Execution generate-webhelp of goal org.openpowerfoundation.docs:openpowerdocs-maven-plugin:1.0.0:generate-webhelp failed: XInclude resource error (sec_template_new_document.xml) and no fallback provided. XProc error err:XD0011: org.xml.sax.SAXParseException; systemId: file:/home/user1/openpower-foundation-docbkx-framework/doc/doc_dev_guide/sec_template_new_document.xml; lineNumber: 55; columnNumber: 17; The element type "para" must be terminated by the matching end-tag "&lt;/para&gt;". -> [Help 1]
...</screen></para>

<para>Like validation errors, three key pieces of information are again provided:</para>
<orderedlist>
<listitem>
<para>The full path and filename of our failure is
<literal>/home/user1/Docs-Template/template/sec_template_new_document.xml</literal>.</para>
<literal>/home/user1/Docs-Template/doc_dev_guide/sec_template_new_document.xml</literal>.</para>
</listitem>
<listitem>
<para>The location within the file of the error is "<literal>lineNumber: 55; columnNumber: 17</literal>.</para>
@ -240,5 +240,30 @@ javax.xml.transform.TransformerException: org.apache.fop.fo.ValidationException:
<link xlink:href="https://www.w3.org/2002/08/XSLFOsummary.html">https://www.w3.org/2002/08/XSLFOsummary.html</link>.</para></note>

</section>
<section xml:id="section_template_debug_java_awt_error">
<title xml:id="section_template_debug_java_awt_error_title">Java AWT exception</title>
<para>Use of Maven in headless environments from Mac OS has uncovered an intermittent exception in the AWT libraries.
This error looks like the following:<screen>...
---------------------------------------------------
Exception in thread "main" java.awt.AWTError: Can't connect to X11 window server using 'localhost:11.0' as the value of the DISPLAY variable.
at sun.awt.X11GraphicsEnvironment.initDisplay(Native Method)
at sun.awt.X11GraphicsEnvironment.access$200(X11GraphicsEnvironment.java:65)
at sun.awt.X11GraphicsEnvironment$1.run(X11GraphicsEnvironment.java:115)
at java.security.AccessController.doPrivileged(Native Method)
at sun.awt.X11GraphicsEnvironment.&lt;clinit&gt;(X11GraphicsEnvironment.java:74)
at java.lang.Class.forName0(Native Method)
at java.lang.Class.forName(Class.java:264)
at java.awt.GraphicsEnvironment.createGE(GraphicsEnvironment.java:103)
at java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment(GraphicsEnvironment.java:82)
at sun.awt.X11.XToolkit.&lt;clinit&gt;(XToolkit.java:126)
...</screen></para>

<para>The circumvention for this error, is force AWT to run headless. This can be accomplished by adding the
<literal>-Djava.awt.headless=true</literal> parameter to the maven invocation such that it looks like this:
<screen><prompt>$ </prompt><userinput>mvn clean generate-sources -Djava.awt.headless=true</userinput></screen></para>
</section>

</section>

@ -19,10 +19,11 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_existing_doc

<title xml:id="section_template_existing_document_title">Modifying an existing document</title>

<para>To begin editing an existing document, you must first clone two projects -- the master document framework project and
the specific document project. Begin by cloning the master document as described in <xref linkend="section_cloning_master_doc"/>.</para>
<para>To begin editing an existing document, you may need to clone up to two projects --
the specific document project, and if not already cloned, the master document framework project too.
If needed, clone the master document as described in <xref linkend="section_cloning_master_doc"/>.</para>
<para>Once complete, obtain a copy of the desired document by cloning its project. For example, to clone this document,
<para>To obtain a copy of the desired document source, clone its project. For example, to clone this document,
<citetitle>Documentation Development Guide</citetitle>, from the
public OpenPOWER Foundation git repository, use this
command:<screen><prompt>$ </prompt><userinput>git clone https://github.com/OpenPOWERFoundation/Docs-Template.git</userinput>
@ -37,7 +38,7 @@ Checking connectivity... done.
<prompt>$ </prompt></screen></para>

<para>To build a specific document such as this guide, follow these steps from the directory where
you just cloned:<screen><prompt>$ </prompt><userinput>cd Docs-Template/template</userinput>
you just cloned:<screen><prompt>$ </prompt><userinput>cd Docs-Template/doc_dev_guide</userinput>
<prompt>$ </prompt><userinput>mvn clean</userinput>
[INFO] Scanning for projects...
[INFO]
@ -46,7 +47,7 @@ Checking connectivity... done.
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ openpower-template-guide ---
[INFO] Deleting ~/Docs-Template/template/target
[INFO] Deleting ~/Docs-Template/doc_dev_guide/target
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
@ -77,7 +78,7 @@ Checking connectivity... done.
in which one wishes to execute them. Thus, the command <literal>mvn clean generate-sources</literal> would accomplish the
same thing as the above sequence of commands.</para></note>

<para>If all goes well, the generated pdf should be available in <literal>~/Docs-Template/template/target/docbkx/webhelp/template-guide/</literal>.</para>
<para>If all goes well, the generated pdf should be available in <literal>~/Docs-Template/doc_dev_guide/target/docbkx/webhelp/template-guide/</literal>.</para>

<para>For assistance correcting commmon build failures, see <xref linkend="section_template_debug"/>.</para>

@ -86,10 +87,44 @@ Checking connectivity... done.
the base project directory will build all projects identified in the <literal>&lt;module></literal> list in the
top-level <literal>pom.xml</literal> file, known as the "Workgroup POM".</para></note>
<para>You are now ready to begin making updates. Before diving deeply into new text,
you may want to review
<xref linkend="section_template_process"/> to ensure that proper Work Product,
Work Process, and security values are selected for your document.</para>
<para>Before diving deeply into text updates,
you should consider the following items for your project and document:
<itemizedlist>
<listitem>
<para>Ensure that the previous version of the tree is tagged.</para>
<para>The command <literal>git tag</literal> may be used to see existing tree tags
and set new ones.
See <xref linkend="section_template_git_commands"/> for more specifics on <literal>git tag</literal> commands.</para>
</listitem>
<listitem>
<para>Reset the document status.</para>
<para>The <literal>pom.xml</literal> file contains the <literal>&lt;documentStatus></literal> field which generally
needs to be reset to the <literal>draft</literal> value. In addition, for non-public work groups, the <literal>&lt;security></literal>
field should be returned to <literal>workgroupConfidential</literal> or <literal>foundationConfidential</literal>
values during the document update process. More information on
document development process can be found in <xref linkend="section_template_process"/>. Detailed information on
key document settings can be found in <xref linkend="section_template_process_pom"/> and
<xref linkend="section_template_process_flowchart"/>.</para>
</listitem>
<listitem>
<para>Incement the new document release information.</para>
<para>The <literal>bk_main.xml</literal> file contains the <literal>&lt;releaseinfo></literal> field
which contains the Versions, Release, and Modification values. Typically, new documents when first being edited will increment the correct value,
reset sub-values to zero, and append a "_preN" tag. During the development process, you will likely increment the "N-value" in your "pre" release
information. Then, at publish, you can remove the "_preN" suffix.</para>
<para>More details on the release information can be found in <xref linkend="section_template_policies"/> recommendation
<xref linkend="section_template_vrm_policy" xrefstyle="select: nopage"/>.</para>
</listitem>
<listitem>
<para>Create a new entry in the revision history.</para>
<para>The <literal>bk_main.xml</literal> file contains the revision history in <literal>&lt;revhistory></literal> table. To start a new entry,
add a new <literal>&lt;revision></literal> entry with <literal>&lt;date></literal> and <literal>&lt;revdescription></literal> fields at the top
of the list of revisions.</para>
</listitem>
</itemizedlist></para>
<para>You are now ready to make textual updates.</para>
</section>

@ -24,10 +24,6 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_faq">
<question><para>Do I have to follow the guidelines in <xref linkend="section_template_policies"/> of this guide?</para></question>
<answer><para>No. <emphasis>HOWEVER</emphasis>, doing so makes it simpler for all community members to participate in maintaining your document.</para></answer>
</qandaentry>
<qandaentry>
<question><para>Question 2...</para></question>
<answer><para>Answer 2...</para></answer>
</qandaentry>
</qandaset>

</section>

@ -145,11 +145,11 @@ Checking connectivity... done.
</listitem>
<listitem>
<para>Change the working directory into the source directory for the <citetitle>Documentation Development Guide</citetitle>.
<screen><prompt>$ </prompt><userinput>cd Docs-Template/template</userinput>
<prompt>Docs-Template/template$ </prompt></screen></para>
<screen><prompt>$ </prompt><userinput>cd Docs-Template/doc_dev_guide</userinput>
<prompt>Docs-Template/doc_dev_guide$ </prompt></screen></para>
</listitem>
<listitem>
<para>Build the document in Maven.<screen><prompt>Docs-Template/template$ </prompt><userinput>mvn generate-sources</userinput>
<para>Build the document in Maven.<screen><prompt>Docs-Template/doc_dev_guide$ </prompt><userinput>mvn generate-sources</userinput>
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
@ -170,10 +170,10 @@ Feb 27, 2018 11:43:28 AM org.apache.fop.apps.FopFactoryConfigurator configure

&lt;!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"&gt;
Parsing: /home/scheel/mydocs/Docs-Template/template/target/docbkx/webhelp/doc-devel-guide/content/section_cloning_project.html
Parsing: /home/scheel/mydocs/Docs-Template/doc_dev_guide/target/docbkx/webhelp/doc-devel-guide/content/section_cloning_project.html
...snip...
The created index files are located in /home/scheel/mydocs/Docs-Template/template/target/docbkx/webhelp/doc-devel-guide/content/search/.js
[INFO] See /home/scheel/mydocs/Docs-Template/template/target/docbkx/webhelp/bk_main for generated file(s)
The created index files are located in /home/scheel/mydocs/Docs-Template/doc_dev_guide/target/docbkx/webhelp/doc-devel-guide/content/search/.js
[INFO] See /home/scheel/mydocs/Docs-Template/doc_dev_guide/target/docbkx/webhelp/bk_main for generated file(s)
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
@ -181,7 +181,7 @@ The created index files are located in /home/scheel/mydocs/Docs-Template/templat
[INFO] Finished at: 2018-02-27T11:43:45-06:00
[INFO] Final Memory: 83M/729M
[INFO] ------------------------------------------------------------------------
<prompt>Docs-Template/template$ </prompt></screen></para>
<prompt>Docs-Template/doc_dev_guide$ </prompt></screen></para>
<note><para>The first time one builds in a Maven environment, the build time will be noticeably
long due to JAR file downloads associated with the new Maven project types. In future builds, these JAR files will
only be downloaded when they are updated. As such, one should both allow for this extra time and not be discouraged
@ -192,11 +192,11 @@ The created index files are located in /home/scheel/mydocs/Docs-Template/templat
Docs-Template project, that directory is <literal>doc-devel-guide</literal>. Inside this directory will
be both the PDF file and the <literal>index.html</literal> file for the HTML document.</para>
<para>To verify this for the <citetitle>Documentation Development Guide</citetitle>, perform these commands:
<screen><prompt>Docs-Template/template$ </prompt><userinput>cd target/docbkx/webhelp/</userinput>
<prompt>Docs-Template/template/target/docbkx/webhelp$ </prompt><userinput>ls</userinput>
<screen><prompt>Docs-Template/doc_dev_guide$ </prompt><userinput>cd target/docbkx/webhelp/</userinput>
<prompt>Docs-Template/doc_dev_guide/target/docbkx/webhelp$ </prompt><userinput>ls</userinput>
doc-devel-guide
<prompt>Docs-Template/template/target/docbkx/webhelp$ </prompt><userinput>cd doc-devel-guide</userinput>
<prompt>Docs-Template/template/target/docbkx/webhelp/doc-devel-guide$ </prompt><userinput>ls</userinput>
<prompt>Docs-Template/doc_dev_guide/target/docbkx/webhelp$ </prompt><userinput>cd doc-devel-guide</userinput>
<prompt>Docs-Template/doc_dev_guide/target/docbkx/webhelp/doc-devel-guide$ </prompt><userinput>ls</userinput>
bookinfo.xml common content doc-devel-guide-20180227.pdf favicon.ico index.html
webapp</screen></para>
<para>Now, you are ready to begin working on your own document. Useful information on how to proceed can

@ -120,7 +120,7 @@ Checking connectivity... done.
<itemizedlist>
<listitem>
<para>If your project exits on GitHub in the OpenPOWER Foundation area and it contains a <literal>template</literal> directory,
<para>If your project exits on GitHub in the OpenPOWER Foundation area and it contains a <literal>doc_template</literal> directory,
then follow the directions in
<xref linkend="section_moving_template_document" endterm="section_moving_template_document_title"/>
to use this document as a base.</para>
@ -144,7 +144,7 @@ Checking connectivity... done.
<para>If this is your first document, in a brand new OpenPOWER Foundation project (on GitHub), you have the fewest number of steps
to perform because your project should have been primed with a single project based on <literal>Docs-Template</literal>.
You can verify this by inspecting
the files in your project directory. A new project will contain a <literal>template</literal> directory, a <literal>pom.xml
the files in your project directory. A new project will contain a <literal>doc_template</literal> directory, a <literal>pom.xml
</literal> file, a <literal>LICENSE</literal> file, and a <literal>README.md</literal> file. If this is the case, you simply
need to perform the following three steps:</para>
@ -154,12 +154,12 @@ Checking connectivity... done.
using the <literal>cd</literal> command:
<screen><prompt>$ </prompt><userinput>cd ~/my_project</userinput>
<prompt>$ </prompt></screen></para>
<para>This directory should contain the <literal>template</literal> folder used to prime the project.</para>
<para>This directory should contain the <literal>doc_template</literal> folder used to prime the project.</para>
</listitem>
<listitem>
<para>Rename the <literal>template</literal> document directory to something new like <literal>my_doc</literal>.
<para>Rename the <literal>doc_template</literal> document directory to something new like <literal>my_doc</literal>.
To accomplish this, use the <literal>mv</literal> command::
<screen><prompt>$ </prompt><userinput>mv template/ my_doc</userinput></screen></para>
<screen><prompt>$ </prompt><userinput>mv doc_template/ my_doc</userinput></screen></para>
</listitem>
<listitem>
<para>Change the project name in the Workgroup POM file (<literal>my_project/pom.xml</literal>). Using your editor, change this line
@ -244,11 +244,11 @@ Checking connectivity... done.
<prompt>$ </prompt></screen></para>
</listitem>
<listitem>
<para>To create a new project directory, simply create a new directory and copy the contents of the <literal>Docs-Template/template</literal>
<para>To create a new project directory, simply create a new directory and copy the contents of the <literal>Docs-Template/doc_dev_guide</literal>
directory. If creating a new project named <literal>my_doc</literal> via a command line, the command
sequence would look like this:
<screen><prompt>$ </prompt><userinput>mkdir my_doc</userinput>
<prompt>$ </prompt><userinput>cp -r Docs-Template/template/* my_doc</userinput>
<prompt>$ </prompt><userinput>cp -r Docs-Template/doc_dev_guide/* my_doc</userinput>
<prompt>$ </prompt></screen></para>
</listitem>
<listitem>
@ -279,15 +279,45 @@ Checking connectivity... done.
and <literal>bk_main.xml</literal>. Within these two files are XML comment tags that begin "<literal>&lt;!-- TODO:</literal>"
to identify places which need customization. The surrounding comments will provide guidance on what needs to change and how
it may be changed. Simply work through each item, making updates as requested.</para>
<para>Pick your setting for document work product type (<literal>&lt;workProduct></literal>,
<para>In the <literal>pom.xml</literal> file, pick your settings for document work product type (<literal>&lt;workProduct></literal>,
work flow status (<literal>&lt;documentStatus></literal>), and
security (<literal>&lt;security></literal>)
carefully. <xref linkend="section_template_process"/> provides an overview of the process
and details the various settings needed in the document core project files. If you still have
questions after reading this section, consult with your Technical Steering Committee
representative.</para>
<note><para>Be sure to remember two key values you used in the <literal>pom.xml</literal> file, <literal>&lt;webhelpDirname&gt;</literal>
<note><para>In addition to the document settings, be sure to remember two key values you used in the <literal>pom.xml</literal>
file, <literal>&lt;webhelpDirname&gt;</literal>
and <literal>&lt;pdfFilenameBase&gt;</literal>, as these will be used to locate your generated document.</para></note>
<para>In the <literal>book.xml</literal> file, you will find the following document unique values which you most likely want to change:
<variablelist>
<varlistentry>
<term><literal>&lt;title></literal></term>
<listitem>
<para>The main title of the document. This appears in the largest font at the top of the title page.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>&lt;subtitle></literal></term>
<listitem>
<para>The second title of the document. This title appears in a smaller font below the <literal>&lt;title></literal> on the title page.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><literal>&lt;realeaseinfo></literal></term>
<listitem>
<para>The document version value. This value should take the form of "Revision V.R.M" as described in
<xref linkend="section_template_policies"/> recommendation <xref linkend="section_template_vrm_policy" xrefstyle="select: nopage"/>.</para>
</listitem>
</varlistentry>
</variablelist>

</para>
<para>When ready, build your new document using standard maven commands like
this:<screen><prompt>$ </prompt><userinput>cd my_project/my_doc</userinput>
<prompt>$ </prompt><userinput>mvn clean</userinput>

@ -26,7 +26,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_policies">
<listitem>
<para>The head book file should be named with the prefix "bk_".</para>
</listitem>
<listitem>
<listitem xml:id="section_template_vrm_policy">
<para>The document versioning as defined by the <literal>&lt;releaseinfo&gt;</literal> tag in the main book
file <literal>bk_xxx</literal> should be named "Revision V.R.M", not "Version V.R.M" or simply "V.R.M" where:</para>
<itemizedlist>
@ -60,6 +60,11 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_policies">
<listitem>
<para>Figures source and images should be placed in the <literal>figures</literal> sub-directory for the document.</para>
</listitem>
<listitem>
<para>Releases of the same document sound be contained in the same tree, but tagged at levels of interest using
the <literal>git tag</literal> command. See the <xref linkend="section_template_git_commands"/> for more specifics
on <literal>git</literal> commands.</para>
</listitem>
</orderedlist>
</para>
<para>In addition to documentation structure, general community/project guidelines are as follows:

@ -439,11 +439,11 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_process">
</itemizedlist>
<para>To create this package for the <citetitle>Documentation Development Guide</citetitle>, one would perform the following commands
in Linux from the document source directory (<literal>.../Docs-Template/template/</literal>):
<screen><prompt>Docs-Template/template$ </prompt><userinput>cd target/docbkx/webhelp/</userinput>
<prompt>Docs-Template/template/target/docbkx/webhelp$ </prompt><userinput>ls</userinput>
in Linux from the document source directory (<literal>.../Docs-Template/doc_dev_guide/</literal>):
<screen><prompt>Docs-Template/doc_dev_guide$ </prompt><userinput>cd target/docbkx/webhelp/</userinput>
<prompt>Docs-Template/doc_dev_guide/target/docbkx/webhelp$ </prompt><userinput>ls</userinput>
doc-devel-guide
<prompt>Docs-Template/template/target/docbkx/webhelp$ </prompt><userinput>zip -rv doc-devel-guide.zip doc-devel-guide/</userinput>
<prompt>Docs-Template/doc_dev_guide/target/docbkx/webhelp$ </prompt><userinput>zip -rv doc-devel-guide.zip doc-devel-guide/</userinput>
adding: doc-devel-guide/ (in=0) (out=0) (stored 0%)
adding: doc-devel-guide/favicon.ico (in=806) (out=806) (stored 0%)
adding: doc-devel-guide/index.html (in=654) (out=385) (deflated 41%)
@ -455,7 +455,7 @@ doc-devel-guide
...snip...
adding: doc-devel-guide/common/jquery/jquery-ui-1.8.2.custom.min.js (in=87032) (out=22729) (deflated 74%)
total bytes=3342807, compressed=1332882 -> 60% savings
<prompt>Docs-Template/template/target/docbkx/webhelp/doc-devel-guide$ </prompt><userinput>ls</userinput>
<prompt>Docs-Template/doc_dev_guide/target/docbkx/webhelp/doc-devel-guide$ </prompt><userinput>ls</userinput>
doc-devel-guide doc-devel-guide.zip</screen></para>
<para>For MacOS and Windows, the steps will be similar with slight variations on the command to create the zip file.</para>
<para>This zip file can be sent to the person managing the documents in the OpenPOWER Resource Catalog.</para>

@ -74,7 +74,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_structure">
The "Workgroup POM" is a minimal POM file that locates the parent, "Master POM" in the <literal>Docs-Master</literal>project directory
with a <literal>&lt;relativePath></literal> definition of <literal>../Docs-Master/pom.xml</literal>.
The document directory contains the unique files used to create the document. The two most important files in the
<literal>Docs-Template/template</literal> directory(and in any project) are the <literal>pom.xml</literal> or "Document POM" which describes
<literal>Docs-Template/doc_dev_guide</literal> directory (and in any project) are the <literal>pom.xml</literal> or "Document POM" which describes
how to build the document and which points to the main document file, the <literal>bk_main.xml</literal> file. This book file
contains all the Docbook source, directly or through include statements (<literal>&lt;xi:include href="..."</literal>),
to build the document.</para>

@ -0,0 +1,30 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<appendix xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="app_template">
<?dbhtml stop-chunking?>
<title>Appendix template</title>
<para>This is the first paragraph of a new appendix...</para>
<section xml:id="sample-app-section">
<title>Section title</title>
<para>Section text...</para>
</section>
</appendix>

@ -0,0 +1,109 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

<!-- The following entity variable is used to reflect the version of the
template document master used for building a document. This value
should be set by copy of the of template used to create a new
document and should not be changed. Use of this value is in
in the Abstract section in this file. -->
<!DOCTYPE book [
<!ENTITY template_version "1.0.0">
]>

<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="bk_main">

<!-- TODO: Pick a Title for the new document -->
<title>Title</title>
<!-- TODO: Either add a subtitle or remove the following line -->
<subtitle>Sub-title</subtitle>

<info>
<author>
<!-- TODO: Set the correct Work Group Name and email id for WG Chair -->
<personname>
TBD Work Group Name
</personname>
<email>tbd-chair@openpowerfoundation.org</email>
<affiliation>
<orgname>OpenPower Foundation</orgname>
</affiliation>
</author>
<copyright>
<year>2018</year>
<holder>OpenPOWER Foundation</holder>
</copyright>
<!-- TODO: Set the correct document releaseinfo -->
<releaseinfo>Revision 1.0_pre1</releaseinfo>
<productname>OpenPOWER</productname>
<pubdate/>

<legalnotice role="apache2">
<!--legalnotice role="opfExternal"-->

<annotation>
<remark>Copyright details are filled in by the template.</remark>
</annotation>
</legalnotice>
<!-- TODO: Update the following text with the correct document description (first paragraph),
Work Group name, and Work Product track (both in second paragraph). -->
<abstract>
<!-- TODO: remove "phrase" tags (2) and text below and insert proper information -->
<para>The purpose of this document is to <phrase role="color:red"><emphasis role="bold">...TBD describe the document</emphasis></phrase></para>
<para>This document is a Standard Track, Workgroup Specification work product owned by the
<phrase role="color:red"><emphasis role="bold">TBD Workgroup</emphasis></phrase> and handled in compliance with the requirements outlined in the
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
created using the <citetitle>Master Template Guide</citetitle> version &template_version;.
Comments, questions, etc. can be submitted to the
public mailing list for the parent specification at
<email>tbd@mailinglist.openpowerfoundation.org</email>.</para>
</abstract>

<revhistory>
<revision>
<!-- TODO: Set correct date and remove "phrase" tags (1) and text below and insert proper information -->
<date>2018-08-29</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para><phrase role="color:red"><emphasis role="bold">TODO: Describe your initial draft, e.g. from where it came if not created from scratch</emphasis></phrase></para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
</revhistory>
</info>

<!-- The ch_preface.xml file is required by all documents -->
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>

<!-- TODO: Add your chapter heading files here. Remove both files and insert your own. -->
<!-- See the template document for naming conventions and location of files. -->
<xi:include href="ch_example.xml"/>

<!-- The app_foundation.xml appendix file is required by all documents. -->
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>

<!-- TODO: The following template document may be modified to create additional appendices as needed. -->
<xi:include href="app_template.xml"/>

</book>

@ -0,0 +1,323 @@
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<chapter version="5.0" xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_template_examples">
<!-- Chapter Title goes here. -->
<title>Documentation examples</title>
<section>
<title>Section Title goes here</title>
<para>This Section covers something of interest to a limited number of people and shows a 1st level section</para>

<section xml:id="list_example_label">
<title>Example Itemized List</title>
<para>
Here is an example of an itemized list</para>
<itemizedlist>
<title>A list title is completely optional</title>
<listitem>
<para>
Item you don't care about</para>
<itemizedlist>
<listitem>
<para>Perhaps you'd like a sub-list</para>
<itemizedlist>
<listitem>
<para>Oooh, here's about another</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
Item you might care about </para>
</listitem>
<listitem>
<para>
Item you do care about </para>
</listitem>
</itemizedlist>
</section>
<section>
<title>Example ordered list</title>
<para>
All good documents need ordered lists.</para>
<orderedlist>
<title>Another purely optional title</title>
<listitem>
<para>First item</para>
</listitem>
<listitem>
<para>Second item</para>
<orderedlist numeration="loweralpha">
<listitem>
<para>first indented item</para>
</listitem>
<listitem>
<para> second indented item</para>
</listitem>
</orderedlist>
</listitem>
<listitem>
<para>Third item</para>
</listitem>
</orderedlist>
</section>

<section>
<title>Example figure with embedded graphic</title>
<para>
Here is how you embed a graphic.</para>
<figure pgwide="1" xml:id="figure_label">
<title>Example figure</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/example_graphic.bmp" format="BMP" scalefit="1" width="100%" />
</imageobject>
</mediaobject>
</figure>
<note><para>Raw images such as the bitmap (bmp) file above may become blurry as they are scaled.
Scalable graphic formats like SVG (Scalable Vector Graphics) embed and scale the best.</para></note>
</section>

<section>
<title>Example table</title>
<para>Of course all good documents need tables. Here's how you build a basic table.</para>

<table frame="all" pgwide="1" xml:id="table_label">
<title>Example Table Title</title>
<tgroup cols="4">
<colspec colname="c1" colwidth="25*" />
<colspec colname="c2" colwidth="25*" />
<colspec colname="c3" colwidth="25*" />
<colspec colname="c4" colwidth="25*" />
<thead>
<row>
<entry>
<para>
<emphasis role="bold">1st Column Heading</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">2nd Column Heading</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">3rd Column Heading</emphasis>
</para>
</entry>
<entry>
<para>
<emphasis role="bold">4th Column Heading</emphasis>
</para>
</entry>
</row>
</thead>
<tbody>
<row>
<entry>
<para>Yes</para>
</entry>
<entry>
<para><phrase role="color:red">Red</phrase></para>
<para><phrase role="color:green">Green</phrase></para>
<para><phrase role="color:blue">Blue</phrase></para>
<para><phrase role="color:#FFBF00">Custom (Amber)</phrase></para>
</entry>
<entry>
<para>MAIN_Junk</para>
</entry>
<entry>
<para>More_Junk</para>
</entry>
</row>
<row>
<entry namest='c1' nameend='c3' align='center'>
<para>merged cells horizontal</para>
</entry>
<entry>
<para>cell_stuff</para>
</entry>
</row>
<row>
<entry morerows='1'>
<para>Merge cells vertical</para>
</entry>
<entry>
<para>filler</para>
</entry>
<entry namest='c3' nameend='c4' morerows='1' align='center'>
<para>merge cells both ways</para>
</entry>
</row>
<row>
<entry>
<para>filler 2</para>
</entry>
</row>
<row>
<entry>
<para>How about we put a list in the table cell</para>
<itemizedlist>
<listitem>
<para>item 1</para>
</listitem>
<listitem>
<para>item 2</para>
</listitem>
<listitem>
<para>item 2</para>
</listitem>
</itemizedlist>
</entry>
<entry>
<para>Another Cell</para>
</entry>
<entry>
<para>Yet Another Cell</para>
</entry>
<entry>
<para>Finally the last cell</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section>
<title>Example of crossreferences and footnotes</title>
<para>To reference another section or table is pretty easy. For example: see <xref linkend="table_label" /> for how tables look.</para>
<para>Lists are shown in <xref linkend="list_example_label" /> and if you need to make a footnote
<footnote xml:id="foot_id"><para>The footnote text goes here and can reference something like <xref linkend="figure_label" /> for additional explanation.</para></footnote>
For clarification that is easy. Of course you might want an additional reference to the footnote <footnoteref linkend="foot_id"/> which can also be done easily.</para>
<para>Lastly you probably want to mark text by making it <emphasis>italic text example</emphasis> or <emphasis role='bold'>Bold Text Example</emphasis>.</para>
</section>
<section>
<title>Example of code citations and user input</title>
<para>When showing user input, you want a nice sceen-looking layout, a prompt, monospace text, and a way to differentiate input from output. Here's an example:
<screen><prompt>$ </prompt><userinput>echo "Hello world"</userinput>
Hello world
<prompt>$ </prompt></screen>
</para>
<para>Docbook also allows for formatting and display of common languages, allowing for whitespace
and line returns just as they are written. Here's a sample snippet of C code with line numbering enabled:<programlisting linenumbering="numbered"><![CDATA[#include<stdio.h>
main()
{
printf("Hello world\n");
}]]></programlisting></para>
<para>If code formatting is not quite what you need, simply displaying text "literally" may suffice as follows: <literal>This is my literal
text. It ignores whitespace.</literal></para>
</section>
<section>
<title>Example of special characters in text</title>
<para>Sometimes in text you need special characters. These can be provided using their UNICODE values such as &#8800; (&amp;#8800),
&#x2126; (&amp;#x2126), and &#8710; (&amp;#8710;).
These can be "coded" using the form <literal>&amp;#</literal><emphasis>ddddd</emphasis><literal>;</literal> where <emphasis>ddddd</emphasis> is
the up to five digit decimal representation of the character. The form <literal>&amp;#x</literal><emphasis>hhhh</emphasis><literal>;</literal> where
<emphasis>hhhh</emphasis> is the up to 4 digit hexidecimal representation of the character.</para>
<para>This formatting works well as long as the symbol to which you are referring is contained in the font set
used for the document -- Arimo for standard text and Cousine for monospace. If when building a document, you see a message like
"WARNING, Glyph...not available in font 'Arimo',"
see <xref linkend="symbol_font" /> in <xref linkend="docbook_extensions" /> for details on using the provided symbol fonts explicitly.</para>
</section>
<xi:include href="sec_example.xml"/>
<section xml:id="docbook_extensions">
<title>Examples of OpenPOWER Foundation Docbook extensions</title>
<para>The OpenPOWER Foundation Maven Plugin supports a number of extensions that are not pure Docbook. These are:</para>

<simplesect>
<title>Setting text color explicitly</title>
<para>Text color can be controlled using <literal>&lt;phrase role="color:</literal><emphasis>color_name</emphasis><literal>"&gt;</literal>
tag where <emphasis>color_name</emphasis> contains the color setting. For example, this
text:<programlisting><![CDATA[<para role="color:red">A red sentence contains a <phrase role="color:blue">blue</phrase> word.</para>]]></programlisting> produces this sentence:</para>
<para role="color:red">A red sentence contains a <phrase role="color:blue">blue</phrase> word.</para>
<para>Valid colors include either a keyword color name or a numerical RGB specification. Keyword names are common with the HTML 4 specificiation:
<literal>aqua</literal>, <literal>black</literal>, <literal>blue</literal>, <literal>fuchsia</literal>, <literal>gray</literal>,
<literal>green</literal>, <literal>lime</literal>, <literal>maroon</literal>, <literal>navy</literal>, <literal>olive</literal>,
<literal>purple</literal>, <literal>red</literal>, <literal>silver</literal>, <literal>teal</literal>, <literal>white</literal>,
and <literal>yellow</literal>. Additionally, RGB values can be <literal>#nnnnnn</literal> where <literal>nnnnnn</literal> is a hexidecimal color value or
<literal>rgb(n1, n2, n3)</literal> where <literal>n1</literal>, <literal>n2</literal>, and <literal>n3</literal> are integers 0-255.</para>
<para>This tag has also been implemented on the following tags: <literal>&lt;thead&gt;</literal>,
<literal>&lt;tbody&gt;</literal>, and <literal>&lt;tfoot&gt;</literal>.</para>
<warning><para>This parameter should only be used for tags listed above.</para></warning>
</simplesect>
<simplesect>
<title>Inserting line breaks</title>
<para>Line breaks can be introduced using <literal>&lt;?linebreak?&gt;</literal> tags. For example, this
text:<programlisting><![CDATA[<para>A line break <?linebreak?> in the middle of text</para>]]></programlisting> produces this sentence:</para>
<para>A line break <?linebreak?> in the middle of text</para>
<para>This tag becomes useful in table text spacing.</para>
</simplesect>
<simplesect>
<title>Inserting page breaks</title>
<para>Page breaks can be introduced using <literal>&lt;?hard-pagebreak?&gt;</literal> tags. For example, this
text:<programlisting><![CDATA[<para>A page break</para> <?hard-pagebreak?> <para>Between two paragraphs</para>]]></programlisting> produces this output:</para>
<para>A page break</para> <?hard-pagebreak?> <para>Between two paragraphs</para>
<para>This tag becomes useful in placing tables on page. Placing this statement before a large table may prevent it from spanning a page.</para>
<warning><para>Because the XSL template behind the Processing Instruction generates
a <programlisting><![CDATA[<fo:block break-after='page'/>]]></programlisting> in
the book FO output, this instruction should be used in the outer most blocks of a section to work effectively. Use inside lists and other structural
components may result in the text after the break being dropped. <emphasis role="bold">User beware!</emphasis>.</para></warning>
</simplesect>
<simplesect>
<title>Varying the font size</title>
<para>Font sizes can also be set using the
<literal>&lt;phrase role="font-size:</literal><emphasis>size</emphasis><literal>"&gt;</literal>
tag where <emphasis>size</emphasis> contains a size value such as "6pt" or "50%" or "1.5em".</para>
<para>For example, a paragraph can be made to be 6 point as follows:<programlisting><![CDATA[<para>A sentence that contains some <phrase role="font-size:6pt">6pt font</phrase>,
<phrase role="font-size:50%">50% font</phrase>, and
<phrase role="font-size:1.5em">1.5em font</phrase> in it.</para>]]></programlisting> produces this output:</para>
<para>A sentence that contains some <phrase role="font-size:6pt">6pt font</phrase>,
<phrase role="font-size:50%">50% font</phrase>, and <phrase role="font-size:1.5em">1.5em font</phrase> in it.</para>
<para>This tag has also been implemented on the following tags: <literal>&lt;para&gt;</literal>,
<literal>&lt;thead&gt;</literal>, <literal>&lt;tbody&gt;</literal>, and <literal>&lt;tfoot&gt;</literal>.</para>
<warning><para>This parameter should only be used for tags listed above.</para></warning>
</simplesect>
<simplesect xml:id="symbol_font">
<title>Using additional symbols</title>
<para>If you find that the Arimo and Cousine fonts do not contain the special symbol you need
for your document, you may use the additional symbol font provided for document (STIX Two Math).
Due to an unimplemented feature in the Apach FO Processor, selection of this
font needs to be explicitly performed using the
<literal>&lt;symbol role="symbolfont"&gt;</literal> wrapper around your symbol value.</para>
<para>For example, the symbol coding of <programlisting><![CDATA[&#x2A01;]]></programlisting> should produce
a circle with a cross in here "&#x2A01;", but instead creates a "Glyph...not available in font 'Arimo'" error
on document build and the PDF renders as a "#".</para>
<para>Re-coding this to use <programlisting><![CDATA[<symbol role="symbolfont">&#x2A01;</symbol>]]></programlisting> produces
the correct symbole here "<symbol role="symbolfont">&#x2A01;</symbol>".</para>
<para>If this still does not provide the symbol you expected, double check the code and the font maps found at
<link xlink:href="http://www.stixfonts.org/charactertable.html">http://www.stixfonts.org/charactertable.html</link>.</para>
</simplesect>
</section>

</section>
</chapter>

Binary file not shown.

After

Width:  |  Height:  |  Size: 648 KiB

@ -0,0 +1,161 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>

<groupId>org.openpowerfoundation.docs</groupId>
<artifactId>workgroup-pom</artifactId>
<version>1.0.0-SNAPSHOT</version>
<relativePath>../pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>

<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
<artifactId>todo-artifact_id</artifactId>

<packaging>jar</packaging>
<!-- TODO: Rename the name field to some appropriate for your new document -->
<name>todo-name</name>

<properties>
<!-- This is set by Jenkins according to the branch. -->
<release.path.name></release.path.name>
<comments.enabled>0</comments.enabled>
</properties>
<!-- ################################################ -->
<!-- USE "mvn clean generate-sources" to run this POM -->
<!-- ################################################ -->
<build>
<plugins>
<plugin>

<groupId>org.openpowerfoundation.docs</groupId>

<artifactId>openpowerdocs-maven-plugin</artifactId>
<!-- version set in ../pom.xml -->
<executions>
<execution>
<id>generate-webhelp</id>
<goals>
<goal>generate-webhelp</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<!-- These parameters only apply to webhelp -->
<enableDisqus>${comments.enabled}</enableDisqus>
<disqusShortname>openpower-template-guide</disqusShortname>
<enableGoogleAnalytics>1</enableGoogleAnalytics>
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
<generateToc>
appendix toc,title
article/appendix nop
article toc,title
book toc,title,figure,table,example,equation
book/appendix nop
book/chapter nop
chapter toc,title
chapter/section nop
section toc
part toc,title
reference toc,title
set toc,title
</generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>1</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>

<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
<webhelpDirname>todo-builddir-name</webhelpDirname>

<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
<pdfFilenameBase>todo-pdfFile-name</pdfFilenameBase>

<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
Consult with the Work Group Chair or a Technical Steering Committee member if you have
questions about which value to select.
If no value is provided below, the document will default to "Work Group Notes".-->
<!--workProduct>workgroupNotes</workProduct-->
<workProduct>workgroupSpecification</workProduct>
<!-- workProduct>candidateStandard</workProduct -->
<!-- workProduct>openpowerStandard</workProduct -->

<!-- TODO: Set the appropriate security policy for the document. For documents
which are not "public" this will affect the document title page and
create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

public = this document may be shared outside the
foundation and thus this setting must be
used only when completely sure it allowed
foundationConfidential = this document may be shared freely with
OpenPOWER Foundation members but may not be
shared publicly
workgroupConfidential = this document may only be shared within the
work group and should not be shared with
other Foundation members or the public

The appropriate starting security for a new document is "workgroupConfidential". -->
<security>workgroupConfidential</security>
<!-- security>foundationConfidential</security -->
<!-- security>public</security -->

<!-- TODO: Set the appropriate work flow status for the document. For documents
which are not "published" this will affect the document title page
and create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

published = this document has completed all reviews and has
been published
draft = this document is actively being updated and has
not yet been reviewed
review = this document is presently being reviewed

The appropriate starting security for a new document is "draft". -->
<documentStatus>draft</documentStatus>
<!-- documentStatus>review</documentStatus -->
<!-- documentStatus>published</documentStatus -->

</configuration>
</execution>
</executions>
<configuration>
<!-- These parameters apply to pdf and webhelp -->
<xincludeSupported>true</xincludeSupported>
<sourceDirectory>.</sourceDirectory>
<includes>
<!-- TODO: If you desire, you may change the following filename to something more appropriate for the new document -->
bk_main.xml
</includes>

<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
<includeCoverLogo>1</includeCoverLogo>
<coverUrl>www.openpowerfoundation.org</coverUrl>
</configuration>
</plugin>
</plugins>
</build>
</project>

@ -0,0 +1,25 @@
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<section version="5.0" xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="section_example">

<title>Sample section include </title>
<para>This section was developed in a separate file but included in the document by using the following
text:<programlisting><![CDATA[ <xi:include href="sec_example.xml"/>]]></programlisting>
where <literal>sec_example.xml</literal> is the source file name.</para>

</section>

@ -0,0 +1,117 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the GNU Free Documentation License, Version 1.3;
with no Invariants Sections, with no Front-Cover Texts,
and with no Back-Cover Texts (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.gnu.org/licenses/fdl-1.3.txt

-->

<!-- The following entity variable is used to reflect the version of the
template document master used for building a document. This value
should be set by copy of the of template used to create a new
document and should not be changed. Use of this value is in
in the Abstract section in this file. -->
<!DOCTYPE book [
<!ENTITY template_version "1.1.0">
]>

<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="bk_main">

<!-- TODO: Replace the text between the brackets <...> (2) with the appropriate information about the base document -->
<title>&lt;TBD Base Document Name&gt; Errata</title>
<subtitle>For &lt;TBD Base Document Name and version&gt;</subtitle>

<info>
<author>
<!-- TODO: Set the correct Work Group Name and email id for WG Chair -->
<!-- **Note: these values should match the base document -->
<personname>
TBD Work Group Name
</personname>
<email>tbd-chair@openpowerfoundation.org</email>
<affiliation>
<orgname>OpenPower Foundation</orgname>
</affiliation>
</author>
<copyright>
<year>2018</year>
<holder>OpenPOWER Foundation</holder>
</copyright>
<releaseinfo>Revision 1.0</releaseinfo>
<productname>OpenPOWER</productname>
<pubdate/>

<!-- TODO: Select one of the two following legalnotice role= values:
"apache2" for an Apache V2 license or
"opfExternal" for an official OpenPOWER Foundation external license text.
If you don't know which one to select, change to "opfExternal" and ask your TSC representative. -->
<!-- **Note: these values should match the base document -->
<!-- legalnotice role="apache2" -->
<!-- legalnotice role="opfExternal" -->
<!-- legalnotice role="gnuFreeDoc"-->
<legalnotice role="apache2">

<annotation>
<remark>Copyright details are filled in by the template.</remark>
</annotation>
</legalnotice>
<abstract>
<!-- TODO: remove "phrase" tags (3) and text below and insert proper information -->
<para>This document provides errata against version
<phrase role="color:red"><emphasis role="bold">#.#.#</emphasis></phrase> of the
<citetitle><phrase role="color:red"><emphasis role="bold">Base Document Title</emphasis></phrase></citetitle>
specification. These errata should be considered part of said specification until such
time as a newer version of the full specification is published.</para>
<para>This document is a Non-standard Track, Work Group Note work
product owned by the
<phrase role="color:red"><emphasis role="bold">TBD Workgroup</emphasis></phrase>
and handled in compliance with the requirements outlined in the
<citetitle>OpenPOWER Foundation Work Group (WG) Process</citetitle> document. It was
created using the <citetitle>Master Template Guide</citetitle> version &template_version;.
Comments, questions, etc. can be submitted to the
public mailing list for the parent specification at
<!-- TODO: Set the mailing list email below -->
<!-- **Note: these values should match the base document -->
<email>tbd@mailinglist.openpowerfoundation.org</email>.</para>
</abstract>

<revhistory>
<revision>
<!-- TODO: Set correct date and remove "phrase" tags (1) and text below and insert proper information -->
<date>2018-08-29</date>
<revdescription>
<itemizedlist spacing="compact">
<listitem>
<para><phrase role="color:red"><emphasis role="bold">TODO: Describe your initial draft, e.g. from where it came if not created from scratch</emphasis></phrase></para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
</revhistory>
</info>

<!-- The ch_preface.xml file is required by all documents -->
<xi:include href="../../Docs-Master/common/ch_preface.xml"/>

<!-- TODO: Add your chapter heading files here. Remove both files and insert your own. -->
<!-- See the template document for naming conventions and location of files. -->
<xi:include href="ch_errata.xml"/>

<!-- The app_foundation.xml appendix file is required by all documents. -->
<xi:include href="../../Docs-Master/common/app_foundation.xml"/>

<!-- TODO: The following template document may be modified to create additional appendices as needed. -->
<!-- xi:include href="app_template.xml"/ -->

</book>

@ -0,0 +1,78 @@
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the GNU Free Documentation License, Version 1.3;
with no Invariants Sections, with no Front-Cover Texts,
and with no Back-Cover Texts (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.gnu.org/licenses/fdl-1.3.txt

-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"
xml:id="dbdoclet.50655240_pgfId-1156194">
<title>Errata</title>

<!-- TODO: remove "phrase" tags (2) and text below and insert proper information -->
<para>The following statements in version
<phrase role="color:red"><emphasis role="bold">#.#.#</emphasis></phrase>
of the
<citetitle><phrase role="color:red"><emphasis role="bold">Base Document Title</emphasis></phrase></citetitle>
specification are incorrect, and should be considered corrected as specified.</para>
<!-- TODO: For each updated section in the referenced section, create a section of the following template -->
<section>
<!-- TODO: replace the <..> information with information from the base document -->
<title>Section &lt;#.#&gt;, &lt;Section Name&gt;</title>
<para>
<emphasis role="underline">Problem</emphasis>:
<!-- TODO: Explain the problem in the section by removing the <phrase> tag and adding appropriate text -->
<phrase role="color:red">TBD: Describe the problem here. For example,
"Paragraph 2 contains a statement that makes use of undefined behavior according to the C standard."
Then, cite the offending text in the next paragraph block.</phrase>
</para>
<para>
<!-- TODO: Quote the offending text. Again remove <phrase> tag and replace with appropriate text. -->
<blockquote>
<para>
<phrase role="color:red">
Regardless of the alignment rules for the allocation of data types,
pointers to both aligned and unaligned data of each data type shall
return the value corresponding to a data type starting at the specified
address when accessed with either the pointer dereference operator * or
the array reference operator [ ].
</phrase>
</para>
</blockquote>
</para>
<para>
<!-- TODO: Describe the resolution. Remove <phrase> tag and replace with appropriate text-->
<emphasis role="underline">Resolution</emphasis>:
<phrase role="color:red">TBD: Describe resolution. For example,
"Paragraph 2 is stricken from the text." If needed, add a block quote of the
updated text like below.</phrase>
</para>

<!-- TODO: If needed, quote the new text, by removing <phrase> tag and replace with appropriate text.
If not needed, remove the outter <para> tag and all contained text. -->
<para>
<blockquote>
<para>
<phrase role="color:red">
C pointer types have an emperical and undefined behavior which applications
should simply tolerate. Therefore and regardless of the alignment rules for
the allocation of data types, pointers to both aligned and unaligned data of
each data type shall return the value corresponding to a data type starting at the specified
address when accessed with either the pointer dereference operator * or
the array reference operator [ ]. Anything that doesn't work is somebody else's
problem.
</phrase>
</para>
</blockquote>
</para>
</section>

</chapter>

@ -0,0 +1,159 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2016 OpenPOWER Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>

<groupId>org.openpowerfoundation.docs</groupId>
<artifactId>workgroup-pom</artifactId>
<version>1.0.0-SNAPSHOT</version>
<relativePath>../pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>

<!-- TODO: Rename the artifactID field to some appropriate for your new document -->
<artifactId>todo-errata</artifactId>

<packaging>jar</packaging>
<!-- TODO: Rename the name field to some appropriate for your new document -->
<name>todo-errata</name>

<properties>
<!-- This is set by Jenkins according to the branch. -->
<release.path.name></release.path.name>
<comments.enabled>0</comments.enabled>
</properties>
<!-- ################################################ -->
<!-- USE "mvn clean generate-sources" to run this POM -->
<!-- ################################################ -->
<build>
<plugins>
<plugin>

<groupId>org.openpowerfoundation.docs</groupId>

<artifactId>openpowerdocs-maven-plugin</artifactId>
<!-- version set in ../pom.xml -->
<executions>
<execution>
<id>generate-webhelp</id>
<goals>
<goal>generate-webhelp</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<!-- These parameters only apply to webhelp -->
<enableDisqus>${comments.enabled}</enableDisqus>
<disqusShortname>openpower-template-guide</disqusShortname>
<enableGoogleAnalytics>1</enableGoogleAnalytics>
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
<generateToc>
appendix toc,title
article/appendix nop
article toc,title
book toc,title,figure,table,example,equation
book/appendix nop
book/chapter nop
chapter toc,title
chapter/section nop
section toc
part toc,title
reference toc,title
set toc,title
</generateToc>
<!-- The following elements sets the autonumbering of sections in output for chapter numbers but no numbered sections-->
<sectionAutolabel>1</sectionAutolabel>
<tocSectionDepth>3</tocSectionDepth>
<sectionLabelIncludesComponentLabel>1</sectionLabelIncludesComponentLabel>

<!-- TODO: Rename the webhelpDirname field to the new directory for new document -->
<webhelpDirname>todo-errata</webhelpDirname>

<!-- TODO: Rename the pdfFilenameBase field to the PDF name for new document -->
<pdfFilenameBase>todo-pdfFile-errata</pdfFilenameBase>

<!-- TODO: Define the appropriate work product type. These values are defined by the IPR Policy.
Consult with the Work Group Chair or a Technical Steering Committee member if you have
questions about which value to select.
If no value is provided below, the document will default to "Work Group Notes".-->
<workProduct>workgroupNotes</workProduct>
<!-- workProduct>workgroupSpecification</workProduct -->
<!-- workProduct>candidateStandard</workProduct -->
<!-- workProduct>openpowerStandard</workProduct -->

<!-- TODO: Set the appropriate security policy for the document. For documents
which are not "public" this will affect the document title page and
create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

public = this document may be shared outside the
foundation and thus this setting must be
used only when completely sure it allowed
foundationConfidential = this document may be shared freely with
OpenPOWER Foundation members but may not be
shared publicly
workgroupConfidential = this document may only be shared within the
work group and should not be shared with
other Foundation members or the public

The appropriate starting security for a new document is "workgroupConfidential". -->
<security>workgroupConfidential</security>
<!-- security>foundationConfidential</security -->
<!-- security>public</security-->

<!-- TODO: Set the appropriate work flow status for the document. For documents
which are not "published" this will affect the document title page
and create a vertical running ribbon on the internal margin of the
security status in all CAPS. Values and definitions are formally
defined by the IPR policy. A layman's definition follows:

published = this document has completed all reviews and has
been published
draft = this document is actively being updated and has
not yet been reviewed
review = this document is presently being reviewed

The appropriate starting security for a new document is "draft". -->
<documentStatus>draft</documentStatus>
<!-- documentStatus>review</documentStatus -->
<!-- documentStatus>published</documentStatus -->
</configuration>
</execution>
</executions>
<configuration>
<!-- These parameters apply to pdf and webhelp -->
<xincludeSupported>true</xincludeSupported>
<sourceDirectory>.</sourceDirectory>
<includes>
bk_main.xml
</includes>

<!-- **TODO: Set to the correct project URL. This likely needs input from the TSC. -->
<!-- canonicalUrlBase>http://openpowerfoundation.org/docs/template-guide/content</canonicalUrlBase -->
<glossaryCollection>${basedir}/../glossary/glossary-terms.xml</glossaryCollection>
<includeCoverLogo>1</includeCoverLogo>
<coverUrl>www.openpowerfoundation.org</coverUrl>
</configuration>
</plugin>
</plugins>
</build>
</project>

@ -17,6 +17,8 @@
<modules>
<!-- TODO: Add new documents are build in the project, add their directories to this list to
enable all document builds from the top level -->
<module>template</module>
<module>doc_dev_guide</module>
<module>doc_template</module>
<module>errata_template</module>
</modules>
</project>

Loading…
Cancel
Save