aneveux / docukes

Docukes is a documentation generator for cucumber-jvm frameworks.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

#Docukes Build Status

##About Docukes is a simple Maven plugin allowing to generate some Markdown documentation for your cucumber-jvm frameworks.

The goal behind it is simply to parse your Java source code, searching for Cucumber annotations in the Java classes, and extract some information out of the annotations and the Javadoc in order to generate some Mardown files that you can use for Github wikis or Github pages in order to document your framework.

##Documentation There's no documentation yet since it's really easy ;) I'll add some if needed/required.

Just add this dependency in the <build></build> section of your pom.xml:

			<plugin>
				<groupId>com.github.aneveux</groupId>
				<artifactId>docukes</artifactId>
				<version>1.0.1</version>
			</plugin>

Then, you can execute the documentation generation with this simple command line: mvn clean docukes:generate

And all Markdown files will be generated under the target/docukes directory.

##Usage Docukes is delivered on its own Maven repository that you can add in your pom.xml:

		<pluginRepository>
			<id>docukes</id>
			<url>https://raw.github.com/aneveux/docukes/mvn-repo/</url>
			<snapshots>
				<enabled>true</enabled>
				<updatePolicy>always</updatePolicy>
			</snapshots>
		</pluginRepository>

##Contribution All feedbacks are welcome.

If you'd like to contribute, don't hesitate to fork & pullrequest ;)

About

Docukes is a documentation generator for cucumber-jvm frameworks.

License:GNU Lesser General Public License v3.0


Languages

Language:Java 100.0%