New docsite, new twitter, new office...

Just a few new things today, all unrelated :slight_smile:

(A)

Of interest to most:

http://ansibleworks.com/docs/ now redirects to our new docsite, which is hosted at http://docs.ansible.com/

What? A new domain name? It’s way shorter, so we’re going to use it. Enterprising readers will have noticed ansible.com/ has been working for a while too.

The new site in particular features a much upgraded docs index, where each module category is separately indexed, but there’s also a list of all modules if you want that too, and each module gets a separate page in the docs. Goodbye infinite scrolling!

Also the docs build fine on your own machine, so it’s easy to see them styled while you are working on them. Just install python-sphinx and it’s a “make webdocs” away.

Note not everything is done and docs are always improving - we are going to look into wiring up the search widget to open up the Google custom search in the near future, and are also (as we’ve mentioned) going to be adding more and more to the “Detailed Guides” section over the coming months.

I’ll remind folks that the docsite are open source, so pull requests can be submitted in GitHub. Most pages have an “edit on GitHub” link right at the top now. The module docs are still generated from the module sources. In a checkout, hop into the “docsite/rst” directory for sources, and the module docs are generated from ./hacking/module_formatter, which has undergone some recent overhaul too. If you see an error and are not comfortable with restructured text format, you can also open tickets on the docs content. (Though for things like typos, we love pull requests when we can get them!)

(B)

Our twitter account has moved! If you were following us before, you will still be following us now, twitter.com/ansible. There’s a note at twitter.com/ansibleworks if you go there by mistake. Saving 5 characters on twitter is a big deal!

(C)

We now have a nice spiffy new office in the American Tobacco Campus in Durham, NC, which (I’m biased) is probably the coolest place you can have an office in NC. I’m hiring for Ansible core and AWX should anyone be interested in joining us, and we expect to be hosting some local meetups there too.

I’ll be taking some more pictures shortly.

Well done !

The previous documentation had me looking all over for something I remembered seeing once... The index makes it a lot better to navigate, even better than what we used to have before. And with some search-capabilities on top and maybe references to well-maintained examples/playbooks/galaxy it's just the icing on the cake !

BTW the breadcrumb at the top seem to be one-level. Not sure if that is intentional.

Thanks!

Yep, breadcrumb wasn’t intentional, but I also wasn’t really clear on how to fix it given there are multiple paths to documents and seems to be what the theme does for some other projects as well. If people want to try to fix it up though, that would be welcome!

Definitely want to get search fixed up though, and will be working on that!

Really great and much easier (for me) to browse the doc ! !
thanks for that !

I would suggest that the welcome/introduction text for this group is updated accordingly as well.

(It’s kinda difficult to follow all these .cc/.com domains :))

Noted. I thought we had scrubed all the .cc references as we haven’t used that in about a year. Will do.

–Michael