mamund / hal-forms

backward-compatible extension for HAL to support dynamic forms at runtime.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Project owner?

spaceone opened this issue · comments

Hello, I have questions about this project:

I found https://rwcbook.github.io/hal-forms/ which links to https://github.com/RWCBook/hal-forms.
And I see that this is the root github repository https://github.com/mamund/hal-forms/.

Who is the owner and founder? Why is that website not linking to this repository. Is it a fork with changes?

And even more interesting, who are the project founder? Are they involved in the IETF? Is there any chance that this specification becomes recognized by the IETF and maybe become a standard or at least a draft. Maybe it inspires HAL so that it goes directly into HAL.
Otherwise this is a nice project but unfortionately also a proprietrary data format.

Thank you very much!
I will consider implementing HAL-FORMS and will soon give feedback by creating new issues or attaching to existing ones.

@spaceone

thanks for the interest and please keep me posted on your experience.

cheers.

@mamund
FYI: I ialready invented my own format, before I heard of hal-forms.
If interested, you can see one example here:
add.json

It basically uses _forms and describes all fields in there. From this data structure I am rendering a complete HTML website, so the API can be used both in a browser as well as via JSON consuming machines.
And for the GUI rendering I am defining _layout, which specifies the order and arrangement of properties in the field. This is not part of the json file currently.

@mamund Maybe it's the wrong approach to invent more and more media types. It would be best to use the existing ones. Wouldn't it be possible to integrate hal-forms into application/hal+json and only specify some new link-relations, which are _embedded and have a certain format?

i'd be happy to see HAL adopt a FORMS approach. was clued in my Mike Kelly that he was not interested in that, so i went ahead and created this extension.

other's have press ahead anyway, i think. 

Hey @mamund, sorry to comment on a long closed issue, but do you think some of the info from this comment of yours could be added to the project's readme?

IMO it would clear a lot of confusion between this repo and the RWCBook/hal-forms repo. And that's quite helpful for potential contributors.

Having contributed to this repo just yesterday, it was not so trivial to figure out where to direct my contribution, especially having in mind the entry point was the published version on https://rwcbook.github.io/hal-forms/.