search

codeforIATI / iati-ideas

💡 Ideas for new codeforIATI projects and blogs
https://ideas.codeforiati.org
0 stars 0 forks source link

[PROJECT IDEA] Fork the schema reference site #34

Open andylolz opened 3 years ago

andylolz commented 3 years ago

Rationale

There are a few issues with the existing reference site that it would be useful to address:

Proposal

andylolz commented 3 years ago

I’ve made a start on this here: https://reference.codeforiati.org

matmaxgeds commented 3 years ago

Loathe to say this as it means more work that I am not qualified to do, but is there an option to pipe it into readthedocs or similar? Whatever the outcome is, I guess we should be prepared to constantly backport new updates done to the official site - if this couldn't be automatic, this might be more work than we can handle?

andylolz commented 3 years ago

is there an option to pipe it into readthedocs or similar?

Yes, that’s exactly what I’d like to do! We should be able to put a readthedocs-style template onto sphinx, which gets us a few of the things in the list above.

I guess we should be prepared to constantly backport new updates done to the official site - if this couldn't be automatic, this might be more work than we can handle?

So, my hope on this is that we can do it automatically. However… Significant changes have been made to IATI-Extra-Documentation to make it compatible with wagtail, so it’s not totally clear yet how easy it will be. (I’ve had to use a very old version of that repo in order to get it working on https://reference.codeforiati.org).

I’m still hopeful at the moment that we can mirror IATI’s source code, and automatically pull in changes as they occur. That’s what we do currently with IATI-Codelists-NonEmbedded, see for example here: https://github.com/codeforIATI/IATI-Codelists-NonEmbedded/pull/61

andylolz commented 3 years ago

I’ve started a new ticket about this here: codeforIATI/reference#3.