Mailinglist Archive: yast-devel (163 mails)

< Previous Next >
Re: [yast-devel] WebYast: Documenting REST API - findings
  • From: Ladislav Slezak <lslezak@xxxxxxx>
  • Date: Tue, 08 Sep 2009 13:28:36 +0200
  • Message-id: <4AA63FE4.2000008@xxxxxxx>
On 7.9.2009 12:21, Cornelius Schumacher wrote:
On Monday 07 September 2009, Ladislav Slezak wrote:

Currently we don't have any standard or guidelines how to document Yast REST

The openSUSE Build Service and SUSE Studio use a tool to create the
from a simple text file specifying the API, and a set of files with example
responses (mostly XML). The tool can be found here:
One example how the generated docs look like is here:

Thanks! This looks great!

The documentation format is simple and it should be easy to document our REST
using restility.

I'd like to integrate it into WebYaST, do you have an RPM package available
somewhere? If we use it in WebYaST we will need an RPM package in OBS, but I
found it there.

(BTW 'rake package' fails, it seems that some files are missing in the SVN
repository, e.g. lib/restility.rb and the version file.)


Best Regards

Ladislav Slez√°k
Yast Developer
SUSE LINUX, s.r.o. e-mail: lslezak@xxxxxxx
Lihovarsk√° 1060/12 tel: +420 284 028 960
190 00 Prague 9 fax: +420 284 028 951
Czech Republic
To unsubscribe, e-mail: yast-devel+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: yast-devel+help@xxxxxxxxxxxx

< Previous Next >
Follow Ups