9

We recently decided to use RAML to document our API and all seems great so far.

We are using the raml2html utility to generate static HTML documentation. The default template works great, but I've seen much better API pages. Does anyone know about some collection of examples/ready-to-use templates?

EDIT: As RAML is evolving, the tools around it are evolving as well. I recently found a very nice theme that might be of interest: https://github.com/wdullaer/raml2html-slate-theme

Miroslav Nedyalkov
  • 1,101
  • 1
  • 10
  • 22
  • Were you able to find good templates / good libraries of templates – bezzoon Aug 11 '16 at 20:45
  • 7
    No, not yet :(. We decided to write our own. You can check it out here - https://gitlab.com/officernd/officernd.gitlab.io and how it looks like here - http://developer.officernd.com – Miroslav Nedyalkov Aug 12 '16 at 09:37
  • Omg thanks so much! : ) I love it! – bezzoon Aug 12 '16 at 15:51
  • 4
    That looks very nice! Why don't you consider sending this to raml2html as a pull request? We're definitely in need of a better default template and more contributors. – Kevin Renskers Feb 11 '17 at 00:10
  • 1
    A huge improvement on the default raml2html template, which I'd say has questionable usability with its modal window approach. I tried the [slate theme](https://github.com/wdullaer/raml2html-slate-theme) which has potential but it's missing some major features - like RAML 1.0 data types – Jeff S. May 23 '17 at 12:12

0 Answers0