RAML 1.0

[JaniszM]

api-console seems not support RAML 1.0 spec. For RAML 0.8 I had to copy content from dist dir into my dir with .raml definitions. This not work for 1.0, Unsupported #%RAML 1.0.

How can I create API for server purpose using RAML 1.0?

[jcenturion]

@JaniszM: API-Console currently does not support RAML 1.0. We are working on it. I let you know. ;)

[JaniszM]

@jcenturion: Do you know maybe if there is other tool I can use? Api-workbench supports RAML 1.0 but seems do not support standalone RAML API project, only via editor :( https://github.com/mulesoft/api-workbench

Can you aproximately say when api-console may support RAML 1.0? :)

[rvegas]

I'm also interested guys. You guys have a plan for this so I could possibly help?

[JaniszM]

Funny thing, api-workbench seems to be only design tool right now ;) I don't see any possibility of running it locally :(

[usarid]

You can't run the API Workbench locally?

On Thu, Nov 5, 2015 at 7:42 AM -0800, "JaniszM" notifications@github.com wrote:

Funny thing, api-workbench seems to be only design tool right now ;) I don't see any possibility of running it locally :(

— Reply to this email directly or view it on GitHub.

[rvegas]

I haven't found a way to check the possible responses based on the types and response examples on it.

[shlomiassaf]

Same here... Couldnt find any notes about tools supporting documentation generation from RAML 1.0

Any clues?

[jcenturion]

@JaniszM, we are currently spiking to calculate the effort needed. I'll let you know once I have the final estimation.

[JaniszM]

@jcenturion thanks, I'm looking forward :)

@usarid Yes. this workbench seems to be only designing tool. I couldn't run designed example in browser :( Lib installed into .atom looks also very poor ;)

[h4t0n]

I'm looking forward :+1:

[aquamatthias]

+1

[felipegs]

+1

[mhonig]

+1

[JaniszM]

@jcenturion So what is the status of estimation or maybe even work on RAML 1.0? :)

[wmccracken]

+1

[sichvoge]

@JaniszM the RAML parser for 1.0 are in a beta stage right now and being finalised by the mid of december. we are working with the workgroup to do that by slowly transition 0.8 to 1.0 in the console. we make sure to update everyone when we are done with this ;)

@dmartinezg do you want to add something?

[JaniszM]

Thanks for info.

[orzeh]

+1

[pradsheth]

+1. Currently I am exploring RAML tools to generate documentation based on 1.0

[pradsheth]

Are any other RAML tools in works for supporting 1.0 other than api-console?

[sichvoge]

@pradsheth it's the api-console, api-designer, we have the api-workbench that already has the support, and of course there will be MuleSoft's ESB and APIkit with support as well.

Other than MuleSoft, I guess there are many other tooling vendors that are currently migrating to 1.0 as well and just waiting for the finalised release for RAML 1.0 to do the last tweaks.

[MikeElghali]

:+1:

[pradsheth]

Thanks @sichvoge I would be very interested in learning about the timeline of these releases. As I understand once the api-console supports 1.0, raml2html will also benefit from 1.0.

[sichvoge]

MuleSoft only owns api-console whereas raml2html is a community project. But I know that there are efforts to support 1.0 there as well.

Can't really speak of timelines though.

[andreidmt]

+1

[ckalima]

@sichvoge any updates on the progress of RAML 1.0 support?

[abaskov]

Also very much interested in RAML 1.0 support from tools, will be happy to get an update.

[sichvoge]

There is a branch here in this repo feature/new-raml that gets all the updates and we already merged multiple PRs. So we are moving forward ;)

[zilionis]

:+1:

[gingermusketeer]

Would i be correct in saying that helping with the new parser is the best thing to do? So that this project can utilize it.

Looks like there are a few things we could help with https://github.com/raml-org/raml-js-parser-2/issues

[donovankim]

+1

[pelizza]

+1

[joshjeong-nsuslab]

:+1:

[k-stasevich]

+1

[tjsnell]

+1

[paulcalabro]

+1

[danielocallaghan]

+1

[sichvoge]

Hi, did you guys tried out the branch here. It is an implementation for the RAML 1.0 support. I'll lock the conversation since adding more +1 does not add to much value to the conversation itself. If you still want to vote, you can use emoji with the original post to upvote it. But we are on that already.

[sichvoge]

The current console supports RAML 1.0. If you have issues with that version, please raise a new issue. I close that issue now.