Hey Kevin and Petr (and anyone else on the list who is interested),
I've been talking with Ben Cotton about moving the elections
application into Communishift[0]. We had a few back and forth e-mails,
and it became clear that it would be helpful if we had quality
documentation describing how community members can use Communishift.
I think there may need to be a balance between documenting how to use
OpenShift, and linking to already existing resources regarding the use
of OpenShift. Perhaps some simple hello world type examples would be
good to document, but it would probably be best to link to official
OpenShift documentation for details on how to use OpenShift.
On the other hand, there are likely to be some particularities with how
we have deployed/configured Communishift that should be documented.
Since we are hoping to hand off several infrastructure applications to
the community, there may be some common patterns among those apps that
would be good to document as well.
It would also be good to document best practices suggestions for some
common problems our users will need to solve:
* How can they use persistent storage?
* How can they use a database?
* How can they back up the applications, persistent storage, and
database?
We do have a wiki page[1] for Communishift already that we can use as a
starting point, but we probably want to move it to our documentation
project as we extend it.
Let me know if you are interested in participating in this project.
[0] Communishift is an OpenShift instance hosted by Fedora
Infrastructure for the community to use to host applications for
Fedora. Fedora Infrastructure does not maintain or administrate any
applications in Communishift, but rather administers the OpenShift
deployment itself.
[1]
https://fedoraproject.org/wiki/Infrastructure/Communishift