search

hughsie / oars

The Open Age Ratings Service
GNU Lesser General Public License v2.1
22 stars 7 forks source link

Create a page to view the full spec #6

Open danirabbit opened 6 years ago

danirabbit commented 6 years ago

Much like the linked page to the TIGRS spec, it would be useful to have a page where we can see the whole spec in one place. At the moment it seems like you have to use the generator to see what is included in OARS.

It would be nice to have this in a human read-able format somewhere in this repo. Especially it would make it easy to open new issues in GitHub linking to specific lines or to be able to submit pull requests

hughsie commented 6 years ago

I think it needs to be something like wayland, where you can take the machine readable spec and generate some beautiful docs, and also generate the generator if you see what I mean. Something XMLy would be easy to parse for me.

danirabbit commented 6 years ago

Yeah I think that makes sense. I was almost going to suggest a yaml or json or something too. The exact file format probably doesn't matter too much :)