cloudfoundry / docs-deploying-cf

The docs repo for material on deploying Cloud Foundry
Apache License 2.0
15 stars 101 forks source link

Does this repo really end up on docs.cloudfoundry.org?? #9

Closed benjsmi closed 10 years ago

benjsmi commented 10 years ago

Looking at https://github.com/cloudfoundry/docs-deploying-cf/blob/master/openstack/index.html.md

The markdown says:


---
title: Deploying Cloud Foundry on OpenStack

---

Follow these steps to install Cloud Foundry on OpenStack using BOSH.

1. [Install the BOSH CLI](http://docs.cloudfoundry.org/bosh/deploy-microbosh.html#cli)

And yet, looking at http://docs.cloudfoundry.org/deploying/openstack/ , this link points to: http://docs.cloudfoundry.org/bosh/setup/

How does one account for the difference? I read somewhere that the docs are built every night, and this markdown has been in the repo for quite some time now.

cf-gitbot commented 10 years ago

We have created an issue in Pivotal Tracker to manage this. You can view the current status of your issue at: http://www.pivotaltracker.com/story/show/68535314

kimahoff commented 10 years ago

Hi programsam,

It's not quite true that the docs build every night. The way docs get to docs.cloudfoundry.org is that a member of the docs team here manually triggers a build to production. This takes place at least once a week, or more frequently if we are aware of high-priority changes that need to be published. (It sounds like we might need to explain this process in a public location, to avoid confusion.)

The discrepancy you noticed was expected: since the change went in less than a week ago, we hadn't yet updated docs.cloudfoundry.org. I just pushed the docs to production a few minutes ago, so the change is now live.

Hope that helps clear things up! Kim

benjsmi commented 10 years ago

@kimahoff

Thanks so much for clearing this up for me. Yeah, I figured it was something like that, but wanted to confirm. Yes, it's probably a good idea to explain it publicly somewhere. Running the build more often might be a good idea too.