pom.xml में टैग टिप्पणियां क्या अच्छी हैं?

Question

मैं वर्तमान में https://spring.io/guides/gs/maven/#scratch के माध्यम से जा रहा हूँ और मैं बस

<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> 

मिल गया और मुझे आश्चर्य है:

क्या के लिए <!-- tag::joda[] --> अच्छा है?

Answer 1

Getting Started Guide आप पढ़ रहे हैं, AsciiDoc फ़ाइल से उत्पन्न होता है:

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

AsciiDoc DocBook एक्सएमएल के लिए कोई दस्तावेज़ प्रारूप बराबर है। स्रोत कोड के प्रति-चिपकने वाले भाग के बजाय, AsciiDoc वाक्यविन्यास स्रोत कोड के कुछ हिस्सों को इंगित करने की अनुमति देता है।

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

जो स्निपेट शामिल होगा:

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

आप सवाल का जवाब देने, <!-- tag::joda[] --> एक मार्कर की इजाजत दी है

pom.xml आप निम्न सिंटैक्स का उपयोग कर सकते हैं का एक हिस्सा शामिल करने के लिए AsciiDoc फ़ाइल का एक हिस्सा निकालने और इसे शुरू करने की मार्गदर्शिका में डालने के लिए।