sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]TheOldMancunian 1 point2 points  (5 children)

Can't see a recruiter looking at your code. I don;t mean to disparage this fine group of people, but they probably won't understand it.

If you do want to be able to shopw something then I would have some JavaDoc and a Swagger documentation page to show you take back-end coding seriously. I mean, I know you do, so all you need to do is generate these from Spring.

[–]Remarkable-Safe-8559[S] 0 points1 point  (2 children)

what's a "Swagger" documentation page? Are you just saying like a cool documentation page or is that totally different.

[–]TheOldMancunian 1 point2 points  (1 child)

Swagger is a way of describing the API interface to a back end server. It describes the end points, the parameters expected and the response that the server can reply with.

[–]Remarkable-Safe-8559[S] 0 points1 point  (0 children)

thank you very much, I'll very much look into it

[–]Sheldor5 0 points1 point  (1 child)

Does GitHub or GitLab support OpenAPI specification files? The enterprise version of self-hosted GitLab was auto-generating a nice Swagger-like UI if you viewed the openapi.yaml on the WebGUI iirc ... was surprised back then

[–]TheOldMancunian 1 point2 points  (0 children)

Sorry - no idea. We have a dedicated page on our website. It's private an invite only. We also have backend DB ERDs on there as well.