Skip to content

tonksol/Augurk

 
 

Repository files navigation

Augurk

Augurk is an always improving, open source, living documentation system designed to get maximum value out of Gherkin-based specifications. By continuously listening to the struggles and desires of various agile teams, Augurk aims to be the most natural fit for anyone wishing to publish their living documentation.

Augurk provides an accessible, easy-to-use overview of all the features describing your application(s) on a webportal you can host within your own organization.

Inspiration

Augurk is greatly influenced by Relish and Pickles. While Relish is a great SaaS application, it requires you to publish your documentation to the cloud. While this is not an issue when your sources live in the cloud as well, in other cases it is often still preferable to keep the documentation within the corporate intranet.
This leaves Pickles. Although Pickles adresses the cloud issue (it was designed for that purpose), it has some short-comings of its own. Pickles generates a neat (Dynamic)HTML website for each project/solution you require it to. It does, however, not incorporate these. This means not only will you get a website for each solution, you can multiply your number of websites with the number of branches you maintain simultaneously.

Augurk has been designed to address exactly these issues. It allows you to publish your features from multiple solutions and branches to a single location, providing you with a single access-point for all your documentation. While Augurk is based upon the same principles as Pickles, it has been rebuild completely from the ground-up, allowing Augurk to provide all the same functionality but simultenously improving and extending it where necessary.

Augurk?

The Gherkin language is used to write Cucumber specifications. Seeing as a Gherkin is a pickled cucumber, the naming of Pickles and Relish (a pickled food item) make perfect sense. Since that doesn't leave much Gherkin related terms in the English language, it was an almost natural choice to switch to a different language. Since Augurk is being developed in The Netherlands, Augurk (meaning pickle[d cucumber]) was a perfect fit.

About

living documentation on your own terms

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 71.8%
  • HTML 12.0%
  • JavaScript 9.5%
  • Gherkin 5.7%
  • CSS 1.0%