greptilian logo

IRC log for #rest, 2015-12-07

https://trygvis.io/rest-wiki/

| Channels | #rest index | Today | | Search | Google Search | Plain-Text | plain, newest first | summary

All times shown according to UTC.

Time S Nick Message
00:11 fuzzyhorns joined #rest
00:43 fumanchu_ joined #rest
01:12 fuzzyhorns joined #rest
02:12 fuzzyhorns joined #rest
02:19 Coldblackice joined #rest
06:02 timg___ joined #rest
06:13 timg___ joined #rest
07:55 Macaveli joined #rest
08:44 Macaveli joined #rest
09:05 Macaveli joined #rest
09:05 interop_madness joined #rest
09:13 graste joined #rest
09:27 Macaveli joined #rest
09:34 timg___ joined #rest
09:42 interop_madness joined #rest
10:09 baweaver joined #rest
10:37 jgornick joined #rest
10:57 timg___ joined #rest
11:19 timg___ joined #rest
12:10 baweaver joined #rest
12:24 bluezone joined #rest
12:32 timg___ joined #rest
13:25 Macaveli joined #rest
14:16 rosstuck joined #rest
14:17 mezod joined #rest
14:17 interop_madness joined #rest
14:26 jgornick joined #rest
14:59 ekroon joined #rest
15:14 saml joined #rest
16:08 baweaver joined #rest
16:24 anth0ny joined #rest
16:26 fumanchu joined #rest
16:40 simonv3 joined #rest
16:55 saml https://apiblueprint.org/  do you use this?
17:11 baweaver joined #rest
17:27 whartung I've not used that saml -- looks almost interesting
17:28 saml i want to write api spec.. and generate documentation and request validator
17:28 saml is there something like this?
17:28 saml targetting node.js server
17:30 whartung I know the guys here use some other popular json documenting thing who's name escapes me.
17:30 saml json schema seems popular
17:30 whartung yea we use taht
17:30 whartung I thought there was something else as well
17:31 saml do you generate documentation off json schema? or write documentation separately?
17:31 whartung right now, we're documenting in a wiki. It's mostly awful, but at least it's usable by everyone vs relying on a build phase to publish it.
17:32 Macaveli joined #rest
17:32 trygvis we just moved our documentation from our internal wiki to markdown inside the app
17:32 trygvis (we exported PDFs from confluence and sendt that by email to customers)
17:32 whartung the wiki is like maven to me -- something nevessary, but I don't actaully care for it
17:33 trygvis now that we have the docs as markdown we can generate some parts of it which is quite nice
17:33 trygvis maven <3
17:33 whartung of course it's frustrating when you focus on the documentation but the develpers don't.
18:09 locks_ joined #rest
18:25 anth0ny joined #rest
18:30 saml how do you keep syncing documentation and actual code that validates?
18:35 trygvis with code reviews, code generation and a two-by-four
18:35 whartung basically
18:49 trygvis :)
18:49 trygvis we generate code and documentation into src/main/resources so they automatically become a part of the code review
19:13 baweaver joined #rest
19:55 timg___ joined #rest
20:37 sfisque joined #rest
22:16 lemur joined #rest
22:34 Coldblackice joined #rest
23:13 simonv3 joined #rest
23:40 Coldblackice joined #rest

| Channels | #rest index | Today | | Search | Google Search | Plain-Text | plain, newest first | summary

https://trygvis.io/rest-wiki/