Re: [atomic-devel] Thoughts on a website redesign

[Brent Baude <bbaude redhat com>]

On Fri, 2016-02-19 at 09:20 -0500, Colin Walters 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
> 
>  - 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.
> 
> * 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
> 

> * 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?
> 

Collin,

We currently are talking with Josh and gang about this as well so you have my support on this suggestion.  Specifically, we are talking about the container-best-practices material that IS written in asciidoc and lives under the projectatomic.io "shield" (so to speak).  

As Josh can attest, there are some technical limitations to this right now given the current setup.  But perhaps, as you suggest, if we break out /docs as a whole, this allows us to explore some new ideas.  

Our proposal to Josh is that ideally we get to a point where a jenkens job would take our asciidoc source and create HTML from it upon merge to master.  

Thanks for bringing this up!

> * Have a steady stream of "tips and tricks"...maybe in the blog
> section?  
>