On Fri, Feb 19, 2016 at 9:20 AM, Colin Walters <walt...@verbum.org> wrote:
> I've been thinking about the website and some improvements/changes we > could make. I don't quite have the web skills to do this myself, but > hoping to start some discussion and get someone involved who does =) > > * First, rather than having Atomic Host itself at the toplevel and in the > Get Started, I think we should have two flows: > > - You want to develop containers on your laptop > This should primarily point to the ADB docs > > +1. > - You want to run containers on servers > This should point to both > https://github.com/openshift/openshift-ansible and > https://github.com/kubernetes/contrib/tree/master/ansible as example > references > for cluster standup. > This in turn should have Atomic Host as well as non-Atomic Hosts as an > option. > Link to the existing docs on install distributions via PXE on bare > metal, cloud images, etc. > > +1. I think we need a landing page that summarizes options, answers why and how > * Talk about Kubernetes more, as it's foundational (Really we could use > some sort of architecture diagram) > > * Link very prominently to our sister project OpenShift Origin > > +1 > * Move http://www.projectatomic.io/docs/ out into something like mkdocs, > asciidoc, or whatever that's better suited to it? Or maybe each > "subproject" like ADB, /usr/bin/atomic, should have its own docs section? > > How about a subdomain docs.projectatomic.io /developers (adb content) /best-practices (under active development) /atomic-registry (under active development) /atomic-platform > * Have a steady stream of "tips and tricks"...maybe in the blog section? > >