You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by sl...@apache.org on 2023/02/09 00:34:07 UTC
svn commit: r1907531 [2/25] - in /maven/website/content: ./ apache-resource-bundles/ archives/maven-2.x/ background/ developers/ developers/conventions/ developers/release/ developers/website/ docs/ docs/2.0.1/ docs/2.0.10/ docs/2.0.11/ docs/2.0.2/ doc...
Modified: maven/website/content/buildExtensionClassRealm.svg
==============================================================================
--- maven/website/content/buildExtensionClassRealm.svg (original)
+++ maven/website/content/buildExtensionClassRealm.svg Thu Feb 9 00:34:05 2023
@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentStyleType="text/css" height="293px" preserveAspectRatio="none" style="width:860px;height:293px;background:#FFFFFF;" version="1.1" viewBox="0 0 860 293" width="860px" zoomAndPan="magnify"><defs/><g><!--class Platform--><g id="elem_Platform"><rect codeLine="33" fill="#F1F1F1" height="64.2969" id="Platform" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="108" x="24.5" y="6.2969"/><ellipse cx="48.5" cy="22.2969" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="M51.4688,27.9375 Q50.8906,28.2344 50.25,28.375 Q49.6094,28.5313 48.9063,28.5313 Q46.4063,28.5313 45.0781,26.8906 Q43.7656,25.2344 43.7656,22.1094 Q43.7656,18.9844 45.0781,17.3281 Q46.4063,15.6719 48.9063,15.6719 Q49.6094,15.6719 50.25,15.8281 Q50.9063,15.9844 51.4688,16.2813 L51.4688,19 Q50.8438,18.4219 50.25,18.1563 Q49.6563,17.875 49.031
3,17.875 Q47.6875,17.875 47,18.9531 Q46.3125,20.0156 46.3125,22.1094 Q46.3125,24.2031 47,25.2813 Q47.6875,26.3438 49.0313,26.3438 Q49.6563,26.3438 50.25,26.0781 Q50.8438,25.7969 51.4688,25.2188 L51.4688,27.9375 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="56" x="64.5" y="27.1436">Platform</text><line style="stroke:#181818;stroke-width:0.5;" x1="25.5" x2="131.5" y1="38.2969" y2="38.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="96" x="30.5" y="55.292">all JRE classes</text><line style="stroke:#181818;stroke-width:0.5;" x1="25.5" x2="131.5" y1="62.5938" y2="62.5938"/></g><!--class Bootstrap--><g id="elem_Bootstrap"><rect codeLine="25" fill="#F1F1F1" height="64.2969" id="Bootstrap" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="143" x="7" y="106.2969"/><ellipse cx="41.35" cy="122.2969" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stro
ke-width:1.0;"/><path d="M44.3188,127.9375 Q43.7406,128.2344 43.1,128.375 Q42.4594,128.5313 41.7563,128.5313 Q39.2563,128.5313 37.9281,126.8906 Q36.6156,125.2344 36.6156,122.1094 Q36.6156,118.9844 37.9281,117.3281 Q39.2563,115.6719 41.7563,115.6719 Q42.4594,115.6719 43.1,115.8281 Q43.7563,115.9844 44.3188,116.2813 L44.3188,119 Q43.6938,118.4219 43.1,118.1563 Q42.5063,117.875 41.8813,117.875 Q40.5375,117.875 39.85,118.9531 Q39.1625,120.0156 39.1625,122.1094 Q39.1625,124.2031 39.85,125.2813 Q40.5375,126.3438 41.8813,126.3438 Q42.5063,126.3438 43.1,126.0781 Q43.6938,125.7969 44.3188,125.2188 L44.3188,127.9375 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="68" x="59.65" y="127.1436">Bootstrap</text><line style="stroke:#181818;stroke-width:0.5;" x1="8" x2="149" y1="138.2969" y2="138.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="131" x="13" y="155.292">Plexus Class
worlds</text><line style="stroke:#181818;stroke-width:0.5;" x1="8" x2="149" y1="162.5938" y2="162.5938"/></g><!--class BuildExtension--><g id="elem_BuildExtension"><rect codeLine="37" fill="#F1F1F1" height="80.5938" id="BuildExtension" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="134" x="159.5" y="206.2969"/><ellipse cx="174.5" cy="222.2969" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="M177.4688,227.9375 Q176.8906,228.2344 176.25,228.375 Q175.6094,228.5313 174.9063,228.5313 Q172.4063,228.5313 171.0781,226.8906 Q169.7656,225.2344 169.7656,222.1094 Q169.7656,218.9844 171.0781,217.3281 Q172.4063,215.6719 174.9063,215.6719 Q175.6094,215.6719 176.25,215.8281 Q176.9063,215.9844 177.4688,216.2813 L177.4688,219 Q176.8438,218.4219 176.25,218.1563 Q175.6563,217.875 175.0313,217.875 Q173.6875,217.875 173,218.9531 Q172.3125,220.0156 172.3125,222.1094 Q172.3125,224.2031 173,225.2813 Q173.6875,226.3438 175.0313,226.3438 Q175.6563,226.3438
176.25,226.0781 Q176.8438,225.7969 177.4688,225.2188 L177.4688,227.9375 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="102" x="188.5" y="227.1436">BuildExtension</text><line style="stroke:#181818;stroke-width:0.5;" x1="160.5" x2="292.5" y1="238.2969" y2="238.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="100" x="165.5" y="255.292">dependencies</text><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="52" x="165.5" y="271.5889">classes</text><line style="stroke:#181818;stroke-width:0.5;" x1="160.5" x2="292.5" y1="278.8906" y2="278.8906"/></g><!--class API--><g id="elem_API"><rect fill="#F1F1F1" height="48" id="API" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="53" x="349" y="114.2969"/><ellipse cx="364" cy="130.2969" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="
M366.9688,135.9375 Q366.3906,136.2344 365.75,136.375 Q365.1094,136.5313 364.4063,136.5313 Q361.9063,136.5313 360.5781,134.8906 Q359.2656,133.2344 359.2656,130.1094 Q359.2656,126.9844 360.5781,125.3281 Q361.9063,123.6719 364.4063,123.6719 Q365.1094,123.6719 365.75,123.8281 Q366.4063,123.9844 366.9688,124.2813 L366.9688,127 Q366.3438,126.4219 365.75,126.1563 Q365.1563,125.875 364.5313,125.875 Q363.1875,125.875 362.5,126.9531 Q361.8125,128.0156 361.8125,130.1094 Q361.8125,132.2031 362.5,133.2813 Q363.1875,134.3438 364.5313,134.3438 Q365.1563,134.3438 365.75,134.0781 Q366.3438,133.7969 366.9688,133.2188 L366.9688,135.9375 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="21" x="378" y="135.1436">API</text><line style="stroke:#181818;stroke-width:0.5;" x1="350" x2="401" y1="146.2969" y2="146.2969"/><line style="stroke:#181818;stroke-width:0.5;" x1="350" x2="401" y1="154.2969" y2="154.2969"/></g><!--class CoreExtension--><g
id="elem_CoreExtension"><rect codeLine="29" fill="#F1F1F1" height="64.2969" id="CoreExtension" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="404" x="173.5" y="6.2969"/><ellipse cx="320.75" cy="22.2969" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="M323.7188,27.9375 Q323.1406,28.2344 322.5,28.375 Q321.8594,28.5313 321.1563,28.5313 Q318.6563,28.5313 317.3281,26.8906 Q316.0156,25.2344 316.0156,22.1094 Q316.0156,18.9844 317.3281,17.3281 Q318.6563,15.6719 321.1563,15.6719 Q321.8594,15.6719 322.5,15.8281 Q323.1563,15.9844 323.7188,16.2813 L323.7188,19 Q323.0938,18.4219 322.5,18.1563 Q321.9063,17.875 321.2813,17.875 Q319.9375,17.875 319.25,18.9531 Q318.5625,20.0156 318.5625,22.1094 Q318.5625,24.2031 319.25,25.2813 Q319.9375,26.3438 321.2813,26.3438 Q321.9063,26.3438 322.5,26.0781 Q323.0938,25.7969 323.7188,25.2188 L323.7188,27.9375 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing"
textLength="101" x="341.25" y="27.1436">CoreExtension</text><line style="stroke:#181818;stroke-width:0.5;" x1="174.5" x2="576.5" y1="38.2969" y2="38.2969"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="392" x="179.5" y="55.292">all packages defined in "/META-INF/maven/extension.xml"</text><line style="stroke:#181818;stroke-width:0.5;" x1="174.5" x2="576.5" y1="62.5938" y2="62.5938"/></g><g id="elem_GMN11"><path d="M420,125.7969 L420,150.9297 L687,150.9297 L687,135.7969 L677,125.7969 L420,125.7969 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M677,125.7969 L677,135.7969 L687,135.7969 L677,125.7969 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="246" x="426" y="142.8638">Just composition of all Core Extensions</text></g><g id="elem_GMN14"><path d="M168,125.7969 L168,150.9297 L331,150.9297 L331,135.7969 L321,
125.7969 L168,125.7969 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M321,125.7969 L321,135.7969 L331,135.7969 L321,125.7969 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="142" x="174" y="142.8638">${maven.home}/boot</text></g><g id="elem_GMN17"><path d="M312,234.2969 L312,259.4297 L853,259.4297 L853,244.2969 L843,234.2969 L312,234.2969 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M843,234.2969 L843,244.2969 L853,244.2969 L843,234.2969 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="520" x="318" y="251.3638">Per GAV of plugin loaded with <extensions>true</extensions> or build extension</text></g><path d="M78.5,70.3047 C78.5,81.7442 78.5,94.703 78.5,106.1544 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><po
lygon fill="none" points="78.5,70.3047,74.5,76.3047,78.5,82.3047,82.5,76.3047,78.5,70.3047" style="stroke:#181818;stroke-width:1.0;"/><path d="M121.7056,170.3874 C137.234,181.5615 154.9643,194.3201 171.3689,206.1248 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="121.7056,170.3874,124.2394,177.1387,131.4459,177.3964,128.9121,170.6451,121.7056,170.3874" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="36" x="134.3689" y="202.1917">many</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="8" x="112.7056" y="183.4543">1</text><path d="M349.4611,162.3632 C346.157,165.0979 342.7831,167.8012 339.5,170.2969 C323.4403,182.5047 305.5033,194.9798 288.7344,206.1818 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="349.4611,162.3632,342.2885,163.1074,340.2168,170.0145,347.3894,169.2703,34
9.4611,162.3632" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="36" x="251.7344" y="202.2487">many</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="8" x="340.4611" y="158.4301">1</text><path d="M375.5,70.3047 C375.5,84.548 375.5,101.1467 375.5,114.2583 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="375.5,70.3047,371.5,76.3047,375.5,82.3047,379.5,76.3047,375.5,70.3047" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="8" x="366.5" y="110.3252">1</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="36" x="338.5" y="83.3716">many</text><path d="M402.2695,138.2969 C408.177,138.2969 414.0844,138.2969 419.9919,138.2969 " fill="none" style="stroke:#181818;stroke-width:1.0;stro
ke-dasharray:7.0,7.0;"/><path d="M150.3066,138.2969 C156.1188,138.2969 161.9309,138.2969 167.743,138.2969 " fill="none" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/><path d="M293.5977,246.7969 C299.7105,246.7969 305.8233,246.7969 311.9362,246.7969 " fill="none" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/></g></svg>
\ No newline at end of file
+<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentStyleType="text/css" height="294px" preserveAspectRatio="none" style="width:856px;height:294px;background:#FFFFFF;" version="1.1" viewBox="0 0 856 294" width="856px" zoomAndPan="magnify"><defs/><g><!--class Platform--><g id="elem_Platform"><rect codeLine="33" fill="#F1F1F1" height="64.4883" id="Platform" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="105" x="26" y="6.4883"/><ellipse cx="47.75" cy="22.4883" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="M50.2231,28.6313 Q49.6421,28.9302 49.0029,29.0796 Q48.3638,29.229 47.6582,29.229 Q45.1514,29.229 43.8315,27.5771 Q42.5117,25.9253 42.5117,22.8042 Q42.5117,19.6748 43.8315,18.0229 Q45.1514,16.3711 47.6582,16.3711 Q48.3638,16.3711 49.0112,16.5205 Q49.6587,16.6699 50.2231,16.9688 L50.2231,19.6914 Q49.5923,19.1104 48.9988,18.8406 Q48.4053,18.57
08 47.7744,18.5708 Q46.4297,18.5708 45.7449,19.6375 Q45.0601,20.7041 45.0601,22.8042 Q45.0601,24.896 45.7449,25.9626 Q46.4297,27.0293 47.7744,27.0293 Q48.4053,27.0293 48.9988,26.7595 Q49.5923,26.4897 50.2231,25.9087 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="58" x="63.25" y="27.7793">Platform</text><line style="stroke:#181818;stroke-width:0.5;" x1="27" x2="130" y1="38.4883" y2="38.4883"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="93" x="32" y="56.0234">all JRE classes</text><line style="stroke:#181818;stroke-width:0.5;" x1="27" x2="130" y1="62.9766" y2="62.9766"/></g><!--class Bootstrap--><g id="elem_Bootstrap"><rect codeLine="25" fill="#F1F1F1" height="64.4883" id="Bootstrap" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="143" x="7" y="106.4883"/><ellipse cx="42.25" cy="122.4883" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-
width:1.0;"/><path d="M44.7231,128.6313 Q44.1421,128.9302 43.5029,129.0796 Q42.8638,129.229 42.1582,129.229 Q39.6514,129.229 38.3315,127.5771 Q37.0117,125.9253 37.0117,122.8042 Q37.0117,119.6748 38.3315,118.0229 Q39.6514,116.3711 42.1582,116.3711 Q42.8638,116.3711 43.5112,116.5205 Q44.1587,116.6699 44.7231,116.9688 L44.7231,119.6914 Q44.0923,119.1104 43.4988,118.8406 Q42.9053,118.5708 42.2744,118.5708 Q40.9297,118.5708 40.2449,119.6375 Q39.5601,120.7041 39.5601,122.8042 Q39.5601,124.896 40.2449,125.9626 Q40.9297,127.0293 42.2744,127.0293 Q42.9053,127.0293 43.4988,126.7595 Q44.0923,126.4897 44.7231,125.9087 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="66" x="60.75" y="127.7793">Bootstrap</text><line style="stroke:#181818;stroke-width:0.5;" x1="8" x2="149" y1="138.4883" y2="138.4883"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="131" x="13" y="156.0234">Plexus Clas
sworlds</text><line style="stroke:#181818;stroke-width:0.5;" x1="8" x2="149" y1="162.9766" y2="162.9766"/></g><!--class BuildExtension--><g id="elem_BuildExtension"><rect codeLine="37" fill="#F1F1F1" height="80.9766" id="BuildExtension" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="134" x="155.5" y="206.4883"/><ellipse cx="170.5" cy="222.4883" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="M172.9731,228.6313 Q172.3921,228.9302 171.7529,229.0796 Q171.1138,229.229 170.4082,229.229 Q167.9014,229.229 166.5815,227.5771 Q165.2617,225.9253 165.2617,222.8042 Q165.2617,219.6748 166.5815,218.0229 Q167.9014,216.3711 170.4082,216.3711 Q171.1138,216.3711 171.7612,216.5205 Q172.4087,216.6699 172.9731,216.9688 L172.9731,219.6914 Q172.3423,219.1104 171.7488,218.8406 Q171.1553,218.5708 170.5244,218.5708 Q169.1797,218.5708 168.4949,219.6375 Q167.8101,220.7041 167.8101,222.8042 Q167.8101,224.896 168.4949,225.9626 Q169.1797,227.0293 170.5244,227.02
93 Q171.1553,227.0293 171.7488,226.7595 Q172.3423,226.4897 172.9731,225.9087 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="102" x="184.5" y="227.7793">BuildExtension</text><line style="stroke:#181818;stroke-width:0.5;" x1="156.5" x2="288.5" y1="238.4883" y2="238.4883"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="95" x="161.5" y="256.0234">dependencies</text><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="48" x="161.5" y="272.5117">classes</text><line style="stroke:#181818;stroke-width:0.5;" x1="156.5" x2="288.5" y1="279.4648" y2="279.4648"/></g><!--class API--><g id="elem_API"><rect fill="#F1F1F1" height="48" id="API" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="54" x="339.5" y="114.4883"/><ellipse cx="354.5" cy="130.4883" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/>
<path d="M356.9731,136.6313 Q356.3921,136.9302 355.7529,137.0796 Q355.1138,137.229 354.4082,137.229 Q351.9014,137.229 350.5815,135.5771 Q349.2617,133.9253 349.2617,130.8042 Q349.2617,127.6748 350.5815,126.0229 Q351.9014,124.3711 354.4082,124.3711 Q355.1138,124.3711 355.7612,124.5205 Q356.4087,124.6699 356.9731,124.9688 L356.9731,127.6914 Q356.3423,127.1104 355.7488,126.8406 Q355.1553,126.5708 354.5244,126.5708 Q353.1797,126.5708 352.4949,127.6375 Q351.8101,128.7041 351.8101,130.8042 Q351.8101,132.896 352.4949,133.9626 Q353.1797,135.0293 354.5244,135.0293 Q355.1553,135.0293 355.7488,134.7595 Q356.3423,134.4897 356.9731,133.9087 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="22" x="368.5" y="135.7793">API</text><line style="stroke:#181818;stroke-width:0.5;" x1="340.5" x2="392.5" y1="146.4883" y2="146.4883"/><line style="stroke:#181818;stroke-width:0.5;" x1="340.5" x2="392.5" y1="154.4883" y2="154.4883"/></g><!--class
CoreExtension--><g id="elem_CoreExtension"><rect codeLine="29" fill="#F1F1F1" height="64.4883" id="CoreExtension" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="416" x="158.5" y="6.4883"/><ellipse cx="311.75" cy="22.4883" fill="#ADD1B2" rx="11" ry="11" style="stroke:#181818;stroke-width:1.0;"/><path d="M314.2231,28.6313 Q313.6421,28.9302 313.0029,29.0796 Q312.3638,29.229 311.6582,29.229 Q309.1514,29.229 307.8315,27.5771 Q306.5117,25.9253 306.5117,22.8042 Q306.5117,19.6748 307.8315,18.0229 Q309.1514,16.3711 311.6582,16.3711 Q312.3638,16.3711 313.0112,16.5205 Q313.6587,16.6699 314.2231,16.9688 L314.2231,19.6914 Q313.5923,19.1104 312.9988,18.8406 Q312.4053,18.5708 311.7744,18.5708 Q310.4297,18.5708 309.7449,19.6375 Q309.0601,20.7041 309.0601,22.8042 Q309.0601,24.896 309.7449,25.9626 Q310.4297,27.0293 311.7744,27.0293 Q312.4053,27.0293 312.9988,26.7595 Q313.5923,26.4897 314.2231,25.9087 Z " fill="#000000"/><text fill="#000000" font-family="sans-serif" font-size="14"
lengthAdjust="spacing" textLength="101" x="332.25" y="27.7793">CoreExtension</text><line style="stroke:#181818;stroke-width:0.5;" x1="159.5" x2="573.5" y1="38.4883" y2="38.4883"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="404" x="164.5" y="56.0234">all packages defined in "/META-INF/maven/extension.xml"</text><line style="stroke:#181818;stroke-width:0.5;" x1="159.5" x2="573.5" y1="62.9766" y2="62.9766"/></g><g id="elem_GMN11"><path d="M411.5,125.9883 L411.5,151.2988 L681.5,151.2988 L681.5,135.9883 L671.5,125.9883 L411.5,125.9883 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M671.5,125.9883 L671.5,135.9883 L681.5,135.9883 L671.5,125.9883 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="249" x="417.5" y="143.5566">Just composition of all Core Extensions</text></g><g id="elem_GMN14"><path d="M168,125.9883 L1
68,151.2988 L321,151.2988 L321,135.9883 L311,125.9883 L168,125.9883 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M311,125.9883 L311,135.9883 L321,135.9883 L311,125.9883 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="132" x="174" y="143.5566">${maven.home}/boot</text></g><g id="elem_GMN17"><path d="M308,234.4883 L308,259.7988 L849,259.7988 L849,244.4883 L839,234.4883 L308,234.4883 " fill="#FEFFDD" style="stroke:#181818;stroke-width:0.5;"/><path d="M839,234.4883 L839,244.4883 L849,244.4883 L839,234.4883 " fill="#FEFFDD" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="520" x="314" y="252.0566">Per GAV of plugin loaded with <extensions>true</extensions> or build extension</text></g><path d="M78.5,70.4961 C78.5,81.9356 78.5,94.8944 78.5,106.3458 " fill="none"
style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="78.5,70.4961,74.5,76.4961,78.5,82.4961,82.5,76.4961,78.5,70.4961" style="stroke:#181818;stroke-width:1.0;"/><path d="M120.5379,170.5788 C135.6466,181.7529 152.8977,194.5115 168.8589,206.3162 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="120.5379,170.5788,122.9834,177.3626,130.1859,177.7143,127.7404,170.9305,120.5379,170.5788" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="34" x="133.8589" y="202.8846">many</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="8" x="111.5379" y="184.1471">1</text><path d="M339.2278,162.7687 C335.9809,165.4118 332.6877,168.035 329.5,170.4883 C313.9151,182.4826 296.646,194.9912 280.6102,206.2972 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="339.2278,162.7687,332.0494,1
63.4544,329.9214,170.3444,337.0998,169.6587,339.2278,162.7687" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="34" x="245.6102" y="202.8655">many</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="8" x="330.2278" y="159.3371">1</text><path d="M366.5,70.4961 C366.5,84.7394 366.5,101.3381 366.5,114.4497 " fill="none" style="stroke:#181818;stroke-width:1.0;"/><polygon fill="none" points="366.5,70.4961,362.5,76.4961,366.5,82.4961,370.5,76.4961,366.5,70.4961" style="stroke:#181818;stroke-width:1.0;"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="8" x="357.5" y="111.0181">1</text><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="34" x="331.5" y="84.0645">many</text><path d="M393.5703,138.4883 C399.5441,138.4883 405.5179,138.4883 411.4918,138.4883 " fill="n
one" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/><path d="M150.1523,138.4883 C156.0491,138.4883 161.9458,138.4883 167.8425,138.4883 " fill="none" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/><path d="M289.5977,246.9883 C295.7105,246.9883 301.8233,246.9883 307.9362,246.9883 " fill="none" style="stroke:#181818;stroke-width:1.0;stroke-dasharray:7.0,7.0;"/></g></svg>
\ No newline at end of file
Modified: maven/website/content/ci-management.html
==============================================================================
--- maven/website/content/ci-management.html (original)
+++ maven/website/content/ci-management.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.1:ci-management at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.4.1:ci-management at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -47,7 +47,7 @@
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li>
<li class="active ">CI Management</li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="download.cgi" title="Download">Download</a></li>
Modified: maven/website/content/code-quality-management.html
==============================================================================
--- maven/website/content/code-quality-management.html (original)
+++ maven/website/content/code-quality-management.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/code-quality-management.md at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/code-quality-management.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -47,7 +47,7 @@
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li>
<li class="active ">Code Quality Management <a href="https://github.com/apache/maven-site/tree/master/content/markdown/code-quality-management.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="download.cgi" title="Download">Download</a></li>
Modified: maven/website/content/community.html
==============================================================================
--- maven/website/content/community.html (original)
+++ maven/website/content/community.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/community.md at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/community.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -47,7 +47,7 @@
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li>
<li class="active ">The Maven Community <a href="https://github.com/apache/maven-site/tree/master/content/markdown/community.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="download.cgi" title="Download">Download</a></li>
Modified: maven/website/content/configure.html
==============================================================================
--- maven/website/content/configure.html (original)
+++ maven/website/content/configure.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/configure.md at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/configure.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -47,7 +47,7 @@
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="index.html" title="Maven">Maven</a><span class="divider">/</span></li>
<li class="active ">Configuring Apache Maven <a href="https://github.com/apache/maven-site/tree/master/content/markdown/configure.md"><img src="./images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="download.cgi" title="Download">Download</a></li>
Modified: maven/website/content/developers/committer-environment.html
==============================================================================
--- maven/website/content/developers/committer-environment.html (original)
+++ maven/website/content/developers/committer-environment.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/developers/committer-environment.apt at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/committer-environment.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -48,8 +48,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
- <li class="active ">Developers centre - Committer Environment <a href="https://github.com/apache/maven-site/tree/master/content/apt/developers/committer-environment.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li class="active ">Developers centre - Committer Environment <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/committer-environment.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li>
@@ -140,19 +140,41 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h1>Committer Environment</h1><section>
-<h2>Introduction</h2>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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><section>
+<h2>Committer Environment</h2><section>
+<h3>Introduction</h3>
<p>This document describes how to set up the Maven committer environment.</p></section><section>
-<h2>Source File Encoding</h2>
+<h3>Source File Encoding</h3>
<p>When editing source files, make sure you use the right file encoding. For the Maven project, UTF-8 has been chosen as the default file encoding. UTF-8 is an encoding scheme for the Unicode character set that can encode all characters that Java can handle. The source files should not contain the byte order mark (BOM). There are exceptions to this general rule. For instance, properties files are encoded using ISO-8859-1 as per the JRE API, so please keep this in mind, too.</p></section><section>
-<h2>Maven Code Style</h2>
+<h3>Maven Code Style</h3>
<p>Refer to <a href="./conventions/code.html">Maven Code Style And Code Conventions</a></p></section><section>
-<h2>Useful software</h2>
+<h3>Useful software</h3>
<p>The Maven Team uses assorted software. Here is a partial list:</p>
<ul>
-<li><a class="externalLink" href="https://www.cygwin.com/">Cygwin</a>: collection of free software tools that allow various versions of Microsoft Windows to act somewhat like a Unix system</li>
-<li><a class="externalLink" href="https://www.gnupg.org/">GnuPG</a>: GNU Privacy Guard.</li></ul></section></section>
+
+<li>
+<p><a href="https://www.cygwin.com/" class="externalLink">Cygwin</a>: collection of free software tools that allow various versions of Microsoft Windows to act somewhat like a Unix system</p></li>
+<li>
+<p><a href="https://www.gnupg.org/" class="externalLink">GnuPG</a>: GNU Privacy Guard.</p></li>
+</ul></section></section></section>
</main>
</div>
</div>
Modified: maven/website/content/developers/committer-settings.html
==============================================================================
--- maven/website/content/developers/committer-settings.html (original)
+++ maven/website/content/developers/committer-settings.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/developers/committer-settings.apt at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/committer-settings.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -10,8 +10,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0-M4" />
- <meta name="author" content="Vincent Siveton
-Dennis Lundberg" />
+ <meta name="author" content="Vincent Siveton, Dennis Lundberg" />
<meta name="date" content="2011-05-23" />
<title>Maven – Developers centre - Committer Settings</title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.11.1.min.css" />
@@ -49,8 +48,8 @@ Dennis Lundberg" />
<ul class="breadcrumb">
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
- <li class="active ">Developers centre - Committer Settings <a href="https://github.com/apache/maven-site/tree/master/content/apt/developers/committer-settings.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li class="active ">Developers centre - Committer Settings <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/committer-settings.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li>
@@ -141,13 +140,32 @@ Dennis Lundberg" />
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h1>Introduction</h1>
-<p>This document is intended to set up the Maven committer settings, i.e. the <code>${user.home}/.m2/settings.xml</code>.</p><section>
-<h2>Enable Apache Servers</h2>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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><section>
+<h2>Introduction</h2>
+<p>This document is intended to set up the Maven committer settings, i.e. the <code>$\{user.home\}/.m2/settings.xml</code>.</p><section>
+<h3>Enable Apache Servers</h3>
<p>Maven uses several servers configuration to deploy snapshots and releases on the Apache servers. You need to tell to Maven what your Apache username is.</p>
-<p><b>It is highly recommended to use Maven's <a href="../guides/mini/guide-encryption.html"> password encryption capabilities</a> for your passwords</b>.</p>
-<div class="source"><pre class="prettyprint linenums"><settings>
+<p><strong>It is highly recommended to use Maven's <a href="../guides/mini/guide-encryption.html">password encryption capabilities</a> for your passwords</strong>.</p>
+
+<div class="source"><pre class="prettyprint linenums"><code><settings>
...
<servers>
<!-- To publish a snapshot of some part of Maven -->
@@ -164,10 +182,12 @@ Dennis Lundberg" />
</server>
...
</servers>
-</settings></pre></div></section><section>
-<h2>Enable sending announcement e-mails</h2>
+</settings>
+</code></pre></div></section><section>
+<h3>Enable sending announcement e-mails</h3>
<p>To be able to send out announcements of Maven releases you need to add a couple of properties to the <code>apache-release</code> profile.</p>
-<div class="source"><pre class="prettyprint linenums"><settings>
+
+<div class="source"><pre class="prettyprint linenums"><code><settings>
...
<profiles>
<profile>
@@ -179,7 +199,8 @@ Dennis Lundberg" />
</profile>
...
</profiles>
-</settings></pre></div></section></section>
+</settings>
+</code></pre></div></section></section></section>
</main>
</div>
</div>
Modified: maven/website/content/developers/compatibility-plan.html
==============================================================================
--- maven/website/content/developers/compatibility-plan.html (original)
+++ maven/website/content/developers/compatibility-plan.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/developers/compatibility-plan.apt at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/compatibility-plan.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -48,8 +48,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
- <li class="active ">Maven Plugins Compatibility Plan <a href="https://github.com/apache/maven-site/tree/master/content/apt/developers/compatibility-plan.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li class="active ">Maven Plugins Compatibility Plan <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/compatibility-plan.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li>
@@ -140,32 +140,63 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h1>Maven Plugins Compatibility Plan</h1><section>
-<h2>Scope</h2>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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><section>
+<h2>Maven Plugins Compatibility Plan</h2><section>
+<h3>Scope</h3>
<p>This page describes the system requirements plan, which consists of:</p>
-<ol style="list-style-type: decimal">
-<li>minimum <b>Java</b> runtime prerequisite for Maven plugins, which can be extended to shared components,</li>
-<li>minimum <b>Maven</b> runtime prerequisite for plugins.</li></ol>
-<p>Such requirements are displayed as "System Requirements" in every plugin info report (see <a href="/plugins/maven-clean-plugin/plugin-info.html">this example</a>).</p>
-<p>Consolidated view for all LATEST plugins release is visible in a <a class="externalLink" href="https://ci-maven.apache.org/job/Maven/job/maven-box/job/maven-dist-tool/job/master/site/dist-tool-prerequisites.html">daily generated report</a>.</p></section><section>
-<h2>Maven Plan</h2>
+<p>1 minimum <strong>Java</strong> runtime prerequisite for Maven plugins, which can be extended to shared components,</p>
+<p>1 minimum <strong>Maven</strong> runtime prerequisite for plugins.</p>
+<p>Such requirements are displayed as “System Requirements” in every plugin info report (see <a href="/plugins/maven-clean-plugin/plugin-info.html">this example</a>).</p>
+<p>Consolidated view for all LATEST plugins release is visible in a <a href="https://ci-maven.apache.org/job/Maven/job/maven-box/job/maven-dist-tool/job/master/site/dist-tool-prerequisites.html" class="externalLink">daily generated report</a>.</p></section><section>
+<h3>Maven Plan</h3>
<ul>
-<li>Until 2012, Maven 2.2.1 + Java 5 prerequisites, with plugins versions in 2.x</li>
-<li>Since 2012, Maven 3.0 + Java 7 prerequisites, with plugins in 3.x.y</li>
-<li>Since June 2020, Maven Plugin API used by plugins >= 3.1.0 + Java 8 prerequisites <a class="externalLink" href="https://s.apache.org/MVN-PLUGIN-MIGRATION-3.1">Technical details</a></li></ul></section><section>
-<h2>Context</h2>
-<ul>
-<li>Maven core history with Java prerequisite is available in the <a href="/docs/history.html">release notes</a></li>
-<li>JDK/JRE availability dates:
+
+<li>
+<p>Until 2012, Maven 2.2.1 + Java 5 prerequisites, with plugins versions in 2.x</p></li>
+<li>
+<p>Since 2012, Maven 3.0 + Java 7 prerequisites, with plugins in 3.x.y</p></li>
+<li>
+<p>Since June 2020, Maven Plugin API used by plugins >= 3.1.0 + Java 8 prerequisites <a href="https://s.apache.org/MVN-PLUGIN-MIGRATION-3.1" class="externalLink">Technical details</a></p></li>
+</ul></section><section>
+<h3>Context</h3>
<ul>
-<li>Java 5 (2004) is closed source, End of Public Update in 2009</li>
-<li>Java 6 (2006) is Open Source, maintained at OpenJDK until 2018</li>
-<li>Java 7 (2011) is Open Source, maintained <a class="externalLink" href="https://wiki.openjdk.java.net/display/jdk7u">at OpenJDK</a> at least until June 2020 </li>
-<li>Java 8 (2014) is Open Source, maintained <a class="externalLink" href="https://wiki.openjdk.java.net/display/jdk8u">at OpenJDK</a> at least until September 2023</li>
-<li>Java 11 (LTS, 2018) is Open Source, maintained <a class="externalLink" href="https://wiki.openjdk.java.net/display/JDKUpdates/JDK11u">at OpenJDK</a> at least until September 2025</li>
-<li>see <a class="externalLink" href="https://javaalmanac.io/jdk/">Java Version Almanac</a> for updated JDK releases</li></ul>
-<p>see also <a class="externalLink" href="https://docs.google.com/document/d/1nFGazvrCvHMZJgFstlbzoHjpAVwv5DEdnaBr_5pKuHo">Java Is Still Free</a> for more details</p></li></ul></section></section>
+
+<li>
+<p>Maven core history with Java prerequisite is available in the <a href="/docs/history.html">release notes</a></p></li>
+<li>
+<p>JDK/JRE availability dates:</p></li>
+<li>
+<p>Java 5 (2004) is closed source, End of Public Update in 2009</p></li>
+<li>
+<p>Java 6 (2006) is Open Source, maintained at OpenJDK until 2018</p></li>
+<li>
+<p>Java 7 (2011) is Open Source, maintained <a href="https://wiki.openjdk.java.net/display/jdk7u" class="externalLink">at OpenJDK</a> at least until June 2020</p></li>
+<li>
+<p>Java 8 (2014) is Open Source, maintained <a href="https://wiki.openjdk.java.net/display/jdk8u" class="externalLink">at OpenJDK</a> at least until September 2023</p></li>
+<li>
+<p>Java 11 (LTS, 2018) is Open Source, maintained <a href="https://wiki.openjdk.java.net/display/JDKUpdates/JDK11u" class="externalLink">at OpenJDK</a> at least until September 2025</p></li>
+<li>
+<p>see <a href="https://javaalmanac.io/jdk/" class="externalLink">Java Version Almanac</a> for updated JDK releases</p></li>
+</ul>
+<p>see also <a href="https://docs.google.com/document/d/1nFGazvrCvHMZJgFstlbzoHjpAVwv5DEdnaBr_5pKuHo" class="externalLink">Java Is Still Free</a> for more details</p></section></section></section>
</main>
</div>
</div>
Modified: maven/website/content/developers/conventions/code.html
==============================================================================
--- maven/website/content/developers/conventions/code.html (original)
+++ maven/website/content/developers/conventions/code.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/developers/conventions/code.apt at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/conventions/code.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -48,8 +48,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
- <li class="active ">Maven Code Style And Code Conventions <a href="https://github.com/apache/maven-site/tree/master/content/apt/developers/conventions/code.apt"><img src="../../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li class="active ">Maven Code Style And Code Conventions <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/conventions/code.md"><img src="../../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi" title="Download">Download</a></li>
@@ -133,84 +133,147 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h1>Maven Code Style And Code Conventions</h1>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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><section>
+<h2>Maven Code Style And Code Conventions</h2>
<p>This document describes the rules for how the sources should be formatted in order to improve consistency, readability and maintainability.</p>
-<p>As the formatting is automatically enforced or even applied with <a class="externalLink" href="https://github.com/diffplug/spotless/tree/main/plugin-maven">spotless-maven-plugin</a> for all projects using <a href="/pom/maven/index.html">Maven Project Parent POM 38 or newer</a> developers usually don't need to care and the following sections are just for informational purposes.</p>
-<p>Optionally you can still import the code style formatter for your IDE from <a class="externalLink" href="https://gitbox.apache.org/repos/asf?p=maven-shared-resources.git;a=tree;f=src/main/resources/config;hb=HEAD">shared-resources</a></p>
-<ul>
-<li><a href="#Generic_Code_Style_And_Convention">Generic Code Style And Convention</a></li>
-<li><a href="#Java">Java</a>
-<ul>
-<li><a href="#Java_Code_Style">Java Code Style</a></li>
-<li><a href="#Java_Code_Convention">Java Code Convention</a></li>
-<li><a href="#Java_Code_Convention_-_import_layouts">Java Code Convention - import layouts</a></li>
-<li><a href="#JavaDoc_Convention">JavaDoc Convention</a></li></ul></li>
-<li><a href="#XML">XML</a>
+<p>As the formatting is automatically enforced or even applied with <a href="https://github.com/diffplug/spotless/tree/main/plugin-maven" class="externalLink">spotless-maven-plugin</a> for all projects using <a href="/pom/maven/index.html">Maven Project Parent POM 38 or newer</a> developers usually don't need to care and the following sections are just for informational purposes.</p>
+<p>Optionally you can still import the code style formatter for your IDE from <a href="https://gitbox.apache.org/repos/asf?p=maven-shared-resources.git;a=tree;f=src/main/resources/config;hb=HEAD" class="externalLink">shared-resources</a></p>
<ul>
-<li><a href="#XML_Code_Style">XML Code Style</a></li>
-<li><a href="#Generic_XML_Code_Convention">Generic XML Code Convention</a></li>
-<li><a href="#POM_Code_Convention">POM Code Convention</a></li>
-<li><a href="#XDOC_Code_Convention">XDOC Code Convention</a></li>
-<li><a href="#FML_Code_Convention">FML Code Convention</a></li></ul></li></ul><section>
-<h2>Generic Code Style And Convention</h2>
+
+<li>
+<p><a href="Generic_Code_Style_And_Convention">Generic Code Style And Convention</a></p></li>
+<li>
+<p><a href="Java">Java</a></p></li>
+<li>
+<p><a href="Java_Code_Style">Java Code Style</a></p></li>
+<li>
+<p><a href="Java_Code_Convention">Java Code Convention</a></p></li>
+<li>
+<p><a href="Java_Code_Convention_-_import_layouts">Java Code Convention - import layouts</a></p></li>
+<li>
+<p><a href="JavaDoc_Convention">JavaDoc Convention</a></p></li>
+<li>
+<p><a href="XML">XML</a></p></li>
+<li>
+<p><a href="XML_Code_Style">XML Code Style</a></p></li>
+<li>
+<p><a href="Generic_XML_Code_Convention">Generic XML Code Convention</a></p></li>
+<li>
+<p><a href="POM_Code_Convention">POM Code Convention</a></p></li>
+<li>
+<p><a href="XDOC_Code_Convention">XDOC Code Convention</a></p></li>
+<li>
+<p><a href="FML_Code_Convention">FML Code Convention</a></p></li>
+</ul><section>
+<h3>Generic Code Style And Convention</h3>
<p>All working files (java, xml, others) should respect the following conventions:</p>
<ul>
-<li><b>License Header</b>: Always add the current <a class="externalLink" href="https://www.apache.org/legal/src-headers.html#headers">ASF license header</a> in all files checked into the source code repository.</li>
-<li><b>Trailing Whitespace</b>: No trailing whitespaces allowed. </li></ul>
+
+<li>
+<p><strong>License Header</strong>: Always add the current <a href="https://www.apache.org/legal/src-headers.html#headers" class="externalLink">ASF license header</a> in all files checked into the source code repository.</p></li>
+<li>
+<p><strong>Trailing Whitespace</strong>: No trailing whitespaces allowed.</p></li>
+</ul>
<p>and the following style:</p>
<ul>
-<li><b>Indentation</b>: <b>Never</b> use tabs!</li>
-<li><b>Line wrapping</b>: Always use a 120-column line width.</li></ul>
-<p><b>Note</b>: The specific styles and conventions, listed in the next sections, can override these generic rules.</p></section><section>
-<h2><a id="Java">Java</a></h2><section>
-<h3><a id="Java_Code_Style">Java Code Style</a></h3>
-<p>Maven adopts the <a class="externalLink" href="https://github.com/palantir/palantir-java-format">palantir Java format</a>.</p></section><section>
-<h3><a id="Java_Code_Convention">Java Code Convention</a></h3>
+
+<li>
+<p><strong>Indentation</strong>: <strong>Never</strong> use tabs!</p></li>
+<li>
+<p><strong>Line wrapping</strong>: Always use a 120-column line width.</p></li>
+</ul>
+<p><strong>Note</strong>: The specific styles and conventions, listed in the next sections, can override these generic rules.</p></section><section>
+<h3>Java</h3><section>
+<h4>Java Code Style</h4>
+<p>Maven adopts the <a href="https://github.com/palantir/palantir-java-format" class="externalLink">palantir Java format</a>.</p></section><section>
+<h4>Java Code Convention</h4>
<p>For consistency reasons, our Java code convention is mainly:</p>
<ul>
-<li><b>Naming</b>: Constants (i.e. static final members) should always be in upper case. Use short, descriptive names for classes and methods.</li>
-<li><b>Organization</b>: Avoid using public inner classes. Prefer interfaces instead of default implementation.</li>
-<li><b>Modifier</b>: Avoid using final modifier on all fields and arguments. Prefer using private or protected fields instead of public fields.</li>
-<li><b>Exceptions</b>: Throw meaningful exceptions to make debugging and testing easier.</li>
-<li><b>Documentation</b>: Document public interfaces well, i.e. all non-trivial public and protected functions should include Javadoc that indicates what they do.</li>
-<li><b>Testing</b>: All non-trivial public classes should have corresponding unit or integration tests.</li></ul></section><section>
-<h3><a id="Java_Code_Convention_-_import_layouts">Java Code Convention - import layouts</a></h3>
+
+<li>
+<p><strong>Naming</strong>: Constants (i.e. static final members) should always be in upper case. Use short, descriptive names for classes and methods.</p></li>
+<li>
+<p><strong>Organization</strong>: Avoid using public inner classes. Prefer interfaces instead of default implementation.</p></li>
+<li>
+<p><strong>Modifier</strong>: Avoid using final modifier on all fields and arguments. Prefer using private or protected fields instead of public fields.</p></li>
+<li>
+<p><strong>Exceptions</strong>: Throw meaningful exceptions to make debugging and testing easier.</p></li>
+<li>
+<p><strong>Documentation</strong>: Document public interfaces well, i.e. all non-trivial public and protected functions should include Javadoc that indicates what they do.</p></li>
+<li>
+<p><strong>Testing</strong>: All non-trivial public classes should have corresponding unit or integration tests.</p></li>
+</ul></section><section>
+<h4>Java Code Convention - import layouts</h4>
<p>For consistency reasons, Java imports should be organized as:</p>
<ul>
-<li>import <b>javax.*</b></li>
-<li>import <b>java.*</b></li>
-<li>blank line</li>
-<li>import <b>all other imports</b></li></ul>
+
+<li>
+<p>import <strong>javax.*</strong></p></li>
+<li>
+<p>import <strong>java.*</strong></p></li>
+<li>
+<p>blank line</p></li>
+<li>
+<p>import <strong>all other imports</strong></p></li>
+</ul>
<p>all imports in each group should be sorted alphabetically.</p>
-<p>To ensure a package import order consistent with the layout described above, download <code><a class="externalLink" href="https://gitbox.apache.org/repos/asf?p=maven-shared-resources.git;a=blob_plain;f=src/main/resources/config/maven-eclipse-importorder.txt;hb=HEAD">maven-eclipse-importorder.txt</a></code>, select <i>Window > Preferences</i> and navigate to <i>Java > Code Style > Organize Imports</i>. Click on <i>Import...</i> and select the downloaded file to change the import order.</p></section><section>
-<h3><a id="JavaDoc_Convention">JavaDoc Convention</a></h3>
+<p>To ensure a package import order consistent with the layout described above, download <code>[maven-eclipse-importorder.txt](https://gitbox.apache.org/repos/asf?p\=maven-shared-resources.git;a\=blob_plain;f\=src/main/resources/config/maven-eclipse-importorder.txt;hb\=HEAD)</code>, select <em>Window > Preferences</em> and navigate to <em>Java > Code Style > Organize Imports</em>. Click on <em>Import…</em> and select the downloaded file to change the import order.</p></section><section>
+<h4>JavaDoc Convention</h4>
<p>TO BE DISCUSSED</p></section></section><section>
-<h2><a id="XML">XML</a></h2><section>
-<h3><a id="XML_Code_Style">XML Code Style</a></h3>
+<h3>XML</h3><section>
+<h4>XML Code Style</h4>
<p>The Maven style for XML files is mainly:</p>
<ul>
-<li><b>Indentation</b>: Always use 2 space indents, unless you're wrapping a new XML tags line in which case you should indent 4 spaces.</li>
-<li><b>Line Breaks</b>: Always use a new line with indentation for complex XML types and no line break for simple XML types. Always use a new line to separate XML sections or blocks, for instance:
-<div class="source"><pre class="prettyprint linenums"><aTag>
+
+<li>
+<p><strong>Indentation</strong>: Always use 2 space indents, unless you're wrapping a new XML tags line in which case you should indent 4 spaces.</p></li>
+<li>
+<p><strong>Line Breaks</strong>: Always use a new line with indentation for complex XML types and no line break for simple XML types. Always use a new line to separate XML sections or blocks, for instance:</p></li>
+</ul>
+
+<div class="source"><pre class="prettyprint linenums"><code><aTag>
<simpleType>This is a simple type</simpleType>
<complexType>
<simpleType>This is a complex type</simpleType>
</complexType>
-</aTag></pre></div>
+</aTag>
+</code></pre></div>
<p>In some cases, adding comments could improve the readability of blocks, for instance:</p>
-<div class="source"><pre class="prettyprint linenums"> <!-- Simple XML documentation --></pre></div>
+
+<div class="source"><pre class="prettyprint linenums"><code> <!-- Simple XML documentation -->
+</code></pre></div>
<p>or</p>
-<div class="source"><pre class="prettyprint linenums"> <!-- ====================================================================== -->
+
+<div class="source"><pre class="prettyprint linenums"><code> <!-- ====================================================================== -->
<!-- Block documentation -->
- <!-- ====================================================================== --></pre></div></li></ul></section><section>
-<h3><a id="Generic_XML_Code_Convention">Generic XML Code Convention</a></h3>
+ <!-- ====================================================================== -->
+</code></pre></div></section><section>
+<h4>Generic XML Code Convention</h4>
<p>No generic code convention exists yet for XML files.</p></section><section>
-<h3><a id="POM_Code_Convention">POM Code Convention</a></h3>
-<p>The team has <a class="externalLink" href="https://lists.apache.org/thread/h8px5t6f3q59cnkzpj1t02wsoynr3ygk">voted</a> during the end of June 2008 to follow a specific POM convention to ordering POM elements. The consequence of this vote is that the <a class="externalLink" href="https://maven.apache.org/ref/current/maven-model/maven.html">Maven project descriptor</a> is <b>no more</b> considered as the reference for the ordering.</p>
+<h4>POM Code Convention</h4>
+<p>The team has <a href="https://lists.apache.org/thread/h8px5t6f3q59cnkzpj1t02wsoynr3ygk" class="externalLink">voted</a> during the end of June 2008 to follow a specific POM convention to ordering POM elements. The consequence of this vote is that the <a href="https://maven.apache.org/ref/current/maven-model/maven.html" class="externalLink">Maven project descriptor</a> is <strong>no more</strong> considered as the reference for the ordering.</p>
<p>The following is the recommended ordering for all Maven POM files:</p>
-<div class="source"><pre class="prettyprint linenums"><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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+<div class="source"><pre class="prettyprint linenums"><code><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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion/>
<parent/>
@@ -254,21 +317,28 @@
<reporting/>
<profiles/>
-</project></pre></div>
-<p><b>Comments</b>:</p>
-<ol style="list-style-type: decimal">
-<li>The <project/> element is always on one line.</li>
-<li>The blocks are voluntary separated by a new line to improve the readingness.</li>
-<li>The dependencies in <dependencies/> and <dependencyManagement/> tags have no specific ordering. Developers are free to choose the ordering, but grouping dependencies by topics (like groupId i.e. <code>org.apache.maven</code>) is a good practice.</li></ol></section><section>
-<h3><a id="XDOC_Code_Convention">XDOC Code Convention</a></h3>
+</project>
+</code></pre></div>
+<p><strong>Comments</strong>:</p>
+<p>1 The <project/> element is always on one line.</p>
+<p>1 The blocks are voluntary separated by a new line to improve the readingness.</p>
+<p>1 The dependencies in <dependencies/> and <dependencyManagement/> tags have no specific ordering. Developers are free to choose the ordering, but grouping dependencies by topics (like groupId i.e. <code>org.apache.maven</code>) is a good practice.</p></section><section>
+<h4>XDOC Code Convention</h4>
<p>For consistency and readability reasons, XDOC files should respect:</p>
<ul>
-<li><b>Metadata</b>: Always specify metadata in the <properties/> tag.</li>
-<li><b>Sections</b>: Always use a new line with indentation for <section/> tags.</li></ul></section><section>
-<h3><a id="FML_Code_Convention">FML Code Convention</a></h3>
+
+<li>
+<p><strong>Metadata</strong>: Always specify metadata in the <properties/> tag.</p></li>
+<li>
+<p><strong>Sections</strong>: Always use a new line with indentation for <section/> tags.</p></li>
+</ul></section><section>
+<h4>FML Code Convention</h4>
<p>For readability reasons, FML files should respect:</p>
<ul>
-<li><b>FAQ</b>: Always use a new line with indentation for <faq/> tags.</li></ul></section></section></section>
+
+<li><strong>FAQ</strong>: Always use a new line with indentation for <faq/> tags.</li>
+</ul><!-- * {APT} Do we need any specific APT style/convention? -->
+</section></section></section></section>
</main>
</div>
</div>
Modified: maven/website/content/developers/conventions/git.html
==============================================================================
--- maven/website/content/developers/conventions/git.html (original)
+++ maven/website/content/developers/conventions/git.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/developers/conventions/git.apt at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/conventions/git.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -48,8 +48,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
- <li class="active ">Maven Git Convention <a href="https://github.com/apache/maven-site/tree/master/content/apt/developers/conventions/git.apt"><img src="../../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li class="active ">Maven Git Convention <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/conventions/git.md"><img src="../../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi" title="Download">Download</a></li>
@@ -133,63 +133,90 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h1>Maven Git Convention</h1>
-<p>This document describes how developers should use Git. </p><section>
-<h2>Git Configuration</h2><section>
-<h3>For contributors who are not committers</h3>
-<p>Apache git repositories are at <i> <<git://git.apache.org</i>>>. However, the ASF uses clones on github.com to make it easier for people to contribute changes via pull requests.</p>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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><section>
+<h2>Maven Git Convention</h2>
+<p>This document describes how developers should use Git.</p><section>
+<h3>Git Configuration</h3><section>
+<h4>For contributors who are not committers</h4>
+<p>Apache git repositories are at _ <<>>. However, the ASF uses clones on github.com to make it easier for people to contribute changes via pull requests.<a href="git://git.apache.org_" class="externalLink">git://git.apache.org_</a></p>
<p>To contribute to a Maven component that is maintained in git, please follow these steps:</p>
-<ol style="list-style-type: decimal">
-<li>create a JIRA for bug or improvement that you wish to work on. The Maven project uses JIRA to organize and track our work, and in particular to keep track of which changes are included in which releases.</li>
-<li>Make a fork of the official ASF clone from github.com. For example, <code>https://github.com/apache/maven-scm</code>.</li>
-<li>Make a branch named after your JIRA ticket. This is not <i>required</i>, but it makes it easier for Maven committers to keep track of your contribution.</li>
-<li>Make your changes. As always, unit or integration tests make it much easier for us to accept your changes.</li>
-<li>Make a pull request to pull your changes to the official clone. Add a link to your pull request to the JIRA. Committers will take it from here.</li></ol></section><section>
-<h3>For committers</h3>
+<p>1 create a JIRA for bug or improvement that you wish to work on. The Maven project uses JIRA to organize and track our work, and in particular to keep track of which changes are included in which releases.</p>
+<p>1 Make a fork of the official ASF clone from github.com. For example, <code>https://github.com/apache/maven-scm</code>.</p>
+<p>1 Make a branch named after your JIRA ticket. This is not <em>required</em>, but it makes it easier for Maven committers to keep track of your contribution.</p>
+<p>1 Make your changes. As always, unit or integration tests make it much easier for us to accept your changes.</p>
+<p>1 Make a pull request to pull your changes to the official clone. Add a link to your pull request to the JIRA. Committers will take it from here.</p></section><section>
+<h4>For committers</h4>
<p>Committers may, of course, commit directly to the ASF repositories. For complex changes, you may find it valuable to make a pull request at github to make it easier to collaborate with others.</p><section>
-<h4><a id="Commit_Message_Template">Commit Message Template</a></h4>
+<h5>Commit Message Template</h5>
<p>Commits should be focused on one issue at a time, because that makes it easier for others to review the commit.</p>
<p>A commit message should use this template:</p>
-<div>
-<pre>[ISSUE-1] <<Summary field from JIRA>>
+
+<div class="source"><pre class="prettyprint linenums"><code>[ISSUE-1] <<Summary field from JIRA>>
Submitted by: <<Name of non-committer>>
-o Comments</pre></div>
+o Comments
+</code></pre></div>
<p>Where:</p>
<ul>
-<li><b>ISSUE-1</b> can be omitted if there was no relevant JIRA issue, though you are strongly encouraged to create one for significant changes.</li>
-<li><b>Submitted by</b> only needs to be specified when a patch is being applied for a non-committer.</li>
-<li><b>Comments</b> some optional words about the solution.</li></ul>
+
+<li>
+<p><strong>ISSUE-1</strong> can be omitted if there was no relevant JIRA issue, though you are strongly encouraged to create one for significant changes.</p></li>
+<li>
+<p><strong>Submitted by</strong> only needs to be specified when a patch is being applied for a non-committer.</p></li>
+<li>
+<p><strong>Comments</strong> some optional words about the solution.</p></li>
+</ul>
<p>eg:</p>
-<div>
-<pre>[MNG-1456] Added the foo to the bar
+
+<div class="source"><pre class="prettyprint linenums"><code>[MNG-1456] Added the foo to the bar
Submitted by: Baz Bazman
-o Applied without change</pre></div></section></section></section><section>
-<h2>Apply User Patch</h2>
-<p>To keep the history of contributions clear, The committer should usually apply the patch without any <b>major</b> modifications, and then create his or her own commits for further modifications. However, committers should never commit code to a live branch which is not suitable to release. If a contribution requires significant work to make it useful, commit it to a branch, fix it up, and merge the branch.</p>
+o Applied without change
+</code></pre></div></section></section></section><section>
+<h3>Apply User Patch</h3>
+<p>To keep the history of contributions clear, The committer should usually apply the patch without any <strong>major</strong> modifications, and then create his or her own commits for further modifications. However, committers should never commit code to a live branch which is not suitable to release. If a contribution requires significant work to make it useful, commit it to a branch, fix it up, and merge the branch.</p>
<p>If the user created a pull request, the committer is responsible for closing that pull request. You do this by adding a note to a commit message:</p>
-<div>
-<pre> Closes #NNN.</pre></div>
+
+<div class="source"><pre class="prettyprint linenums"><code> Closes #NNN.
+</code></pre></div>
<p>where NNN is the number of the pull request.</p></section><section>
-<h2>Edit Commit Message</h2>
+<h3>Edit Commit Message</h3>
<p>to edit last commit comment:</p>
-<div>
-<pre>$ git commit --amend -m "new comment"</pre></div></section><section>
-<h2>Workflow</h2>
+
+<div class="source"><pre class="prettyprint linenums"><code>$ git commit --amend -m "new comment"
+</code></pre></div></section><section>
+<h3>Workflow</h3>
<p>Workflow for svn folks is something like :</p>
-<div>
-<pre> $ git pull
+
+<div class="source"><pre class="prettyprint linenums"><code> $ git pull
$ hack hack hack
$ git push
// fails, because someone else has already pushed to master
$ git pull
// this creates some merges
- $ git push</pre></div>
+ $ git push
+</code></pre></div>
<p>A more quiet workflow :</p>
-<div>
-<pre>$ git pull
+
+<div class="source"><pre class="prettyprint linenums"><code>$ git pull
$ hack hack hack
$ git push
// fails, because someone else has already pushed to master
@@ -197,43 +224,50 @@ $ git fetch
// this moves 'origin/master'
$ git rebase origin/master
// this reapplies your local changes on top of origin/master
-$ git push</pre></div></section><section>
-<h2>Other useful Git commands while developing</h2>
+$ git push
+</code></pre></div></section><section>
+<h3>Other useful Git commands while developing</h3>
<p>If you've done a chunk of work and you would like to ditch your changes and start from scratch use this command to revert to the original checkout:</p>
-<div>
-<pre>$ git checkout .</pre></div>
+
+<div class="source"><pre class="prettyprint linenums"><code>$ git checkout .
+</code></pre></div>
<p>TODO .gitignore</p><section>
-<h3>power-git checkout</h3>
+<h4>power-git checkout</h4>
<p>This checkout is typical for highly experienced git users, and may serve as inspiration for others; as usual the best way to learn is by doing. Sample shown for maven-surefire</p>
-<p>Go to https://github.com/apache/maven-surefire and fork surefire to your own github account.</p>
+<p>Go to <a href="https://github.com/apache/maven-surefire" class="externalLink">https://github.com/apache/maven-surefire</a> and fork surefire to your own github account.</p>
<p>Starting with nothing (no existing clone)</p>
-<div>
-<pre>git clone https://github.com/<youraccount>/maven-surefire.git
+
+<div class="source"><pre class="prettyprint linenums"><code>git clone https://github.com/<youraccount>/maven-surefire.git
git remote add apache https://git-wip-us.apache.org/repos/asf/maven-surefire.git
git remote add asfgithub https://github.com/apache/maven-surefire.git
git config --add remote.asfgithub.fetch "+refs/pull/*/head:refs/remotes/asfgithub/pr/*"
-git fetch --all</pre></div>
-<p>(You may consider adding --global to the git config statement above to always fetch pull requests for any remote named "asfgithub")</p>
-<p>In this setup, running "git push" will normally push to your personal github account. Furthermore, all pull requests from github are also fetched to your local clone, use</p>
-<div>
-<pre>gitk --all</pre></div>
+git fetch --all
+</code></pre></div>
+<p>(You may consider adding –global to the git config statement above to always fetch pull requests for any remote named “asfgithub”)</p>
+<p>In this setup, running “git push” will normally push to your personal github account. Furthermore, all pull requests from github are also fetched to your local clone, use</p>
+
+<div class="source"><pre class="prettyprint linenums"><code>gitk --all
+</code></pre></div>
<p>to try to make some sense of it all. This is an important command to understand! (gitk may need to be installed additionally)</p>
<p>gitk also has a quite excellent context menu that is far more context sensitive than most people realize at first impression. Right-clicking on a commit in a github pull-request will allow you to cherry-pick straight in the gui.</p>
<p>If you're working on the master branch, you can do stuff like this:</p>
-<div>
-<pre>git push # your github account
-git push apache # the authoritative apache repo</pre></div>
+
+<div class="source"><pre class="prettyprint linenums"><code>git push # your github account
+git push apache # the authoritative apache repo
+</code></pre></div>
<p>Using your github account as a storage for half-finished work is excellent if you switch between multiple computers, always push to github before leaving your current computer and start by pulling at the next computer.</p>
<p>To merge a pull request</p>
-<div>
-<pre>git merge pr/10 # merge pull request number 10 from asf@github into master
-git push apache # upload to apache</pre></div>
+
+<div class="source"><pre class="prettyprint linenums"><code>git merge pr/10 # merge pull request number 10 from asf@github into master
+git push apache # upload to apache
+</code></pre></div>
<p>Or if you're comfortable with rebasing;</p>
-<div>
-<pre>
+
+<div class="source"><pre class="prettyprint linenums"><code>
git checkout pr/10
git rebase apache/master
-git push apache</pre></div></section></section></section>
+git push apache
+</code></pre></div></section></section></section></section>
</main>
</div>
</div>
Modified: maven/website/content/developers/conventions/jira.html
==============================================================================
--- maven/website/content/developers/conventions/jira.html (original)
+++ maven/website/content/developers/conventions/jira.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/conventions/jira.md at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/conventions/jira.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -47,7 +47,7 @@
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
<li class="active ">Maven JIRA Conventions <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/conventions/jira.md"><img src="../../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../../download.cgi" title="Download">Download</a></li>
Modified: maven/website/content/developers/dependency-policies.html
==============================================================================
--- maven/website/content/developers/dependency-policies.html (original)
+++ maven/website/content/developers/dependency-policies.html Thu Feb 9 00:34:05 2023
@@ -2,7 +2,7 @@
<!--
- | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/apt/developers/dependency-policies.apt at 2023-02-08
+ | Generated by Apache Maven Doxia Site Renderer 2.0.0-M4 from content/markdown/developers/dependency-policies.md at 2023-02-09
| Rendered using Apache Maven Fluido Skin 1.11.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
@@ -48,8 +48,8 @@
<ul class="breadcrumb">
<li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../index.html" title="Maven">Maven</a><span class="divider">/</span></li>
- <li class="active ">Maven Dependency Policies <a href="https://github.com/apache/maven-site/tree/master/content/apt/developers/dependency-policies.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
- <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-08</li>
+ <li class="active ">Maven Dependency Policies <a href="https://github.com/apache/maven-site/tree/master/content/markdown/developers/dependency-policies.md"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li>
+ <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2023-02-09</li>
<li class="pull-right"><span class="divider">|</span>
<a href="../scm.html" title="Get Sources">Get Sources</a></li>
<li class="pull-right"><a href="../download.cgi" title="Download">Download</a></li>
@@ -140,26 +140,48 @@
</div>
</header>
<main id="bodyColumn" class="span10" >
-<section>
-<h1>Maven Dependency Policies</h1><section>
-<h2>Scope</h2>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you 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><section>
+<h2>Maven Dependency Policies</h2><section>
+<h3>Scope</h3>
<p>This page describes the policies around the use of dependencies by the Apache Maven Developers in the process of developing Apache Maven itself.</p>
-<p>This page does not apply to projects hosted outside of the Apache Maven project. In order to remove all doubt, this page only applies to code which has a Github URL that starts with <code>https://github.com/apache/maven</code> or a Gitbox URL starting with <code>https://gitbox.apache.org/repos/asf?p=maven</code></p>
+<p>This page does not apply to projects hosted outside of the Apache Maven project. In order to remove all doubt, this page only applies to code which has a Github URL that starts with <code>https://github.com/apache/maven</code> or a Gitbox URL starting with <code>https://gitbox.apache.org/repos/asf?p\=maven</code></p>
<p>If you have stumbled across this page and you are working on code that does not have a Github URL starting with <code>https://github.com/apache/maven</code> then this page does not apply to you.</p></section><section>
-<h2>Background</h2>
+<h3>Background</h3>
<p>The Apache Maven PMC is tasked with ensuring (among other things) that all legal issues are addressed and that each and every release is the product of the community as a whole.</p>
<p>The Apache Maven project consists of quite a number of components. For the purposes of this policy, we will make a distinction between the core Maven distribution and all the other components.</p>
-<p>The core Maven distribution is the binary and source distributions made available from the https://maven.apache.org/download page. </p></section><section>
-<h2>Applicability</h2>
+<p>The core Maven distribution is the binary and source distributions made available from the <a href="https://maven.apache.org/download" class="externalLink">https://maven.apache.org/download</a> page.</p></section><section>
+<h3>Applicability</h3>
<p>This policy applies to all changes to dependencies as and from Subversion revision 1067464.</p></section><section>
-<h2>Core Maven Distribution Dependencies</h2>
+<h3>Core Maven Distribution Dependencies</h3>
<p>All dependencies which are included in the Core Maven Distribution must either:</p>
<ul>
-<li>be licensed under a <a class="externalLink" href="https://www.apache.org/legal/resolved.html#category-a">Category A license</a>; or</li>
-<li>be licensed under a <a class="externalLink" href="https://www.apache.org/legal/resolved.html#category-b">Category B license</a> and approved by a majority vote of the Apache Maven PMC.</li></ul>
-<p>Votes for Category B licenses will be held on the dev@maven.apache.org mailing list. A majority of the PMC must vote in favour of a Category B licensed dependency before a release can be made containing that dependency.</p></section><section>
-<h2>Non-Core Dependencies</h2>
-<p>Non-Core components may only use Category A or Category B licenses.</p></section></section>
+
+<li>
+<p>be licensed under a <a href="https://www.apache.org/legal/resolved.html#category-a" class="externalLink">Category A license</a>; or</p></li>
+<li>
+<p>be licensed under a <a href="https://www.apache.org/legal/resolved.html#category-b" class="externalLink">Category B license</a> and approved by a majority vote of the Apache Maven PMC.</p></li>
+</ul>
+<p>Votes for Category B licenses will be held on the <a href="mailto:dev@maven.apache.org" class="externalLink">dev@maven.apache.org</a> mailing list. A majority of the PMC must vote in favour of a Category B licensed dependency before a release can be made containing that dependency.</p></section><section>
+<h3>Non-Core Dependencies</h3>
+<p>Non-Core components may only use Category A or Category B licenses.</p></section></section></section>
</main>
</div>
</div>