Ivan Lazar Miljenovic
41d75b4de8
Combine rendering of code samples for request/response bodies
...
This does mean that the "Example" portion for reqeust bodies is lost
though.
2017-10-05 16:29:43 +11:00
Ivan Lazar Miljenovic
4f8df0ebe2
Make sure code blocks are indented in markdown documentation
...
This relies on the behaviour of pandoc, and as such may not apply to
other Markdown renderers.
Before this change, you would have something like:
> - Example: `application/json`
>
> ```javascript
> "HELLO, HASKELLER"
> ```
When converting this to HTML, PDF, etc. the code block is _not_
contained within the bullet point.
With this change, the generated markdown looks like:
> - Example: `application/json`
>
> ```javascript
> "HELLO, HASKELLER"
> ```
With pandoc at least, this effectively indents the entire code block
to be under the bullet point, which is the intended effect.
Note that the code itself is _not_ indented (which might break other
Markdown renderers) as to do so would require splitting on newlines,
which may have unintended consequences when dealing with generated
values (may contain `\r\n`, etc.).
2017-10-05 16:29:43 +11:00
Ivan Lazar Miljenovic
061bf7a5b1
Add markdown type for text/xml
...
As it's an alternative mime-type for XML
2017-10-05 16:29:43 +11:00
Alp Mestanogullari
4a6edd7864
Merge pull request #813 from ivan-m/response-content-type
...
List content type with response examples
2017-09-25 10:38:02 +02:00
Ivan Lazar Miljenovic
81184df3d4
List content type with response examples
2017-09-22 14:12:13 +10:00
Oleg Grenrus
50be3a263b
Merge pull request #767 from fierce-katie/docs-combinators
...
Description and Summary combinators
2017-08-16 15:31:12 +03:00
Ivan Lazar Miljenovic
36029f555f
Add Changelog entries for my recent pull requests
...
As requests by @phadej in #790
2017-08-01 10:33:47 +10:00
Oleg Grenrus
24035ddd85
Merge pull request #790 from ivan-m/query-param-method
...
Document the type of endpoint a parameter belongs to
2017-07-31 11:41:13 +03:00
Oleg Grenrus
a9bc22d5c9
Merge pull request #788 from ivan-m/header-location
...
Move location of header information
2017-07-31 11:40:41 +03:00
Ivan Lazar Miljenovic
a2c6ef773d
Changed to adding a Headers header
...
As per request by @phadej
2017-07-31 10:56:01 +10:00
Ivan Lazar Miljenovic
6fc4c735c4
Merge branch 'master' into query-param-method
2017-07-28 22:52:34 +10:00
Oleg Grenrus
53b352711b
Merge pull request #787 from ivan-m/doc-auth-lenses
...
Export authentication-related types/lenses
2017-07-28 15:13:23 +03:00
Ivan Lazar Miljenovic
31578b9bfa
Make defAction's documentation visible to Haddock
2017-07-28 16:39:52 +10:00
Ivan Lazar Miljenovic
256ee41254
Update documentation such that it isn't just for GET
2017-07-28 16:39:05 +10:00
Ivan Lazar Miljenovic
89e0a98ac5
Document the type of endpoint a parameter belongs to
...
Closes #760
2017-07-28 16:31:55 +10:00
Ivan Lazar Miljenovic
7221368cdd
Move location of header information
...
Currently, it appears after the notes, authentication and capture
information... such that if any of those exist, then the list of
header sensitivity will appear to be an item of one of the previous
ones (as they provide Markdown headers).
2017-07-28 15:32:19 +10:00
Ivan Lazar Miljenovic
8e67e26d63
Export authentication-related types/lenses
...
I'm assuming that they're not meant to be just in `.Internal`.
2017-07-28 15:15:16 +10:00
Oleg Grenrus
213620e56a
Fix cabal category
2017-07-25 10:46:57 +03:00
Oleg Grenrus
c46dd1aff9
Bump servant-docs version to 0.11
2017-07-24 10:54:11 +03:00
Ismail
2d271dc127
Fix broken link
2017-07-06 16:43:37 +01:00
ishiy
1ba7624e69
Improve authStr in markdown
2017-06-29 19:01:46 +09:00
Catherine Galkina
be0878cdd8
Fix tests for different GHC versions
2017-06-19 18:58:25 +03:00
Catherine Galkina
272e47c3d3
Increase stack size for GHC-7.8.4 tests
2017-06-19 14:59:26 +03:00
Catherine Galkina
ec0431d930
Add instances for new combinators
2017-06-08 18:27:36 +03:00
Oleg Grenrus
ec930ac9a8
Release 0.11
2017-05-24 08:02:56 +03:00
Oleg Grenrus
f0eec498a1
Merge pull request #755 from osa1/fix_reqbody_samples
...
Don't drop samples in `HasDocs ReqBody` instance
2017-05-19 14:58:06 +03:00
Ömer Sinan Ağacan
d8dd1cb90a
Don't drop samples in HasDocs ReqBody
instance
...
As reported in #754 , `HasDocs` instance of `ReqBody` was dropping samples other
than the first one. With this patch we show at most `_maxSamples` samples for
`ReqBody`, and also include the sample title in the docs.
2017-05-16 14:19:52 +03:00
David Turner
4b7ffc9461
Add test that EmptyAPI does not generate any docs
2017-05-16 10:29:27 +00:00
David Turner
2cfa71891b
Add instance HasDocs EmptyAPI
2017-05-16 10:07:15 +00:00
Ivan Lazar Miljenovic
16a45e0d0f
Import correct Servant module in README
2017-04-07 10:33:22 +10:00
Oleg Grenrus
8a3ecb2ebc
Classify changelog into breaking and other changes
2017-02-01 09:06:30 +02:00
Oleg Grenrus
736918a694
Tweaks for 0.10 ( #694 )
...
* Add Servant category to in-repo packages
* Add version table
2017-01-30 19:12:39 +02:00
Oleg Grenrus
93df8d22df
Bump version to 0.10
2017-01-26 20:10:01 +02:00
Oleg Grenrus
fdf86b0e15
Add Semigroup instances
2017-01-19 20:11:54 +02:00
Julian K. Arni
92b1196830
Redundant import fixes
2017-01-16 13:20:39 +02:00
Nickolay Kudasov
a6de4ba123
Remove IsIn from servant-docs
2017-01-16 13:20:39 +02:00
Julian K. Arni
4fd31a60fb
Bump version.
...
To 0.9.1.1
2016-10-27 13:25:27 +02:00
Julian K. Arni
9e809a0756
Bump version.
...
To 0.9.1.
2016-10-26 17:35:57 +02:00
Julian K. Arni
3ddf225cec
Bump version.
...
To 0.9.0.1.
2016-10-09 22:52:49 +02:00
Sönke Hahn
bc1a3e7faa
bump version
2016-09-17 11:47:57 -04:00
Julian Arni
29af0bbdf9
Merge pull request #585 from axman6/axman6/get-headers-581
...
Replace use of ToByteString with HttpApiData for GetHeaders
2016-09-06 20:59:46 -03:00
Julian K. Arni
bf824a3889
Bump version to 0.8.1
2016-09-02 13:09:47 -03:00
Alex Mason
5bef76ed03
Remove all use of bytestring-conversion
2016-09-02 23:27:37 +10:00
Arian van Putten
c5dcff12d0
Add dummy docs instancE
2016-07-11 14:47:05 +01:00
Jonathan Lange
ed702f5927
servant-docs support for CaptureAll
2016-07-11 14:47:05 +01:00
Sönke Hahn
8eb412ff23
bump version
2016-07-10 17:21:36 +02:00
Arian van Putten
05379ed7e3
Replace all occurances of () with NoContent
...
We use NoContent to signify an empty response nowadays. This commit
replaces all occurences of () with NoContent so that all packages use
the new semantics.
2016-07-10 16:58:59 +02:00
Sönke Hahn
5effdfdbbb
Rename type variables 'layout' and 'sublayout' to 'api'
2016-07-03 22:46:46 +08:00
Sönke Hahn
d8a4cce691
version bump
2016-05-11 12:09:25 +08:00
Julian K. Arni
7174f5185d
Changelog updates for GHC 8.0 support.
2016-05-10 22:45:29 +02:00