Co to są komentarze tagów dobre dla pom.xml?

Question

Jestem obecnie przeżywa https://spring.io/guides/gs/maven/#scratch a ja po prostu znaleźć

<dependencies> 
    <!-- tag::joda[] --> 
    <dependency> 
     <groupId>joda-time</groupId> 
     <artifactId>joda-time</artifactId> 
     <version>2.9.2</version> 
    </dependency> 
    <!-- end::joda[] --> 
    <!-- tag::junit[] --> 
    <dependency> 
     <groupId>junit</groupId> 
     <artifactId>junit</artifactId> 
     <version>4.12</version> 
     <scope>test</scope> 
    </dependency> 
    <!-- end::junit[] --> 
</dependencies> 

i zastanawiam się:

Co jest dobre dla <!-- tag::joda[] -->?

Answer 1

Getting Started Guide czytasz, jest generowany z pliku AsciiDoc:

https://github.com/spring-projects/spring-boot/blob/master/README.adoc

asciidoc jest dokumentem Format równoważne DocBook XML. Zamiast kopiować część kodu źródłowego, składnia AsciiDoc pozwala wskazać niektóre części kodu źródłowego.

Aby dołączyć część pom.xml można użyć następującej składni:

include::complete/pom.xml[tag=joda] 

który obejmie fragment:

<!-- tag::joda[] --> 
<dependency> 
    <groupId>joda-time</groupId> 
    <artifactId>joda-time</artifactId> 
    <version>2.9.2</version> 
</dependency> 
<!-- end::joda[] --> 

Aby odpowiedzieć na ty pytanie, <!-- tag::joda[] --> jest markerem pozwalając AsciiDoc, aby wyodrębnić część pliku i wstawić go do podręcznika wprowadzającego.