Asciidoctor for documenting REST APIs
Since more than 30 years I have to write good documentation. On the university I used to write documents with TeX and LaTeX because of the high quality output. The more professional the output is, the more professional the content looks to the reader. LaTeX offers a lot of possibilities to style your document so the reading can be fun. But LaTeX isn’t that simple. In my current projects I searched for a documentation tool that is wide spread, free and simple. The answer was Asciidoctor for me.
(more…)Simple API Documentation with Spring Auto REST Docs
Maybe you have heard of Spring REST Docs? There is another possibility to simplify the API documentation process: Spring Auto REST Docs!
(more…)Spring Auto REST Docs with Maven
I want to show you, what changes to your Maven pom.xml you have to make to add Spring Auto REST Docs to your project. At then end you only have to copy-and-paste some code from this blog and there you go!
(more…)Log4j2 configuration in a separate file
Did you ever deploy a jar to production and then need to change the log4j2 configuration for some package? Changing the jar on-the-fly or a new deployment was like stuck between a rock and a hard place. Then I found the following easy solution.
(more…)Microservice as a Windows service
A lot of companies use a Windows server to host microservices. I asked myself “what is the best way to deploy and start a microservice?”. Of course, the microservice has to be a Windows service so that on every server restart the services are restarted too. But what else is necessary?
(more…)Spring Boot Web with Undertow
Although Tomcat is the most common application server it also tends to add some overhead to a small microservice. Lets have a look at the alternatives.
(more…)Deploy to Artifactory
Do you write your own library or framework and want to share it within your team? Then you should deploy your code to your own repository. I use Artifactory as a repository in my profession and I’m totally happy with this solution. Now I like to show you how easy it is to upload your code to the open-source version of Artifactory.
(more…)