IBM-Cloud / tf-ibm-docs

IBM Cloud Terraform (tm) Provider documentation
https://ibm-cloud.github.io/tf-ibm-docs/
MIT License
2 stars 4 forks source link

ibm-bluemix.github.io/tf-ibm-docs/ should point to the latest stable version #11

Open renier opened 7 years ago

renier commented 7 years ago

Right now it points to v0.5.0, but the latest afaik is v0.5.1... or v0.6.0. Hard to tell from the commits.

renier commented 7 years ago

The documentation landing page (what is shown when you https://ibm-bluemix.github.io/tf-ibm-docs/) presents the documentation for whatever version that Schematics is currently using.

I think there is a mix of concerns here. One concern is to let the Schematics user know what is the latest version of the IBM Cloud Terraform provider it is using. The other is to show the latest stable documentation of the IBM Cloud Terraform provider.

For the former, that information should go somewhere here with a link to the version it is using (e.g. ibm-bluemix.github.io/tf-ibm-docs/v0.5.0/). For the latter, the ibm-bluemix.github.io/tf-ibm-docs/ url should just point to the latest stable for the benefit of those directly using the open source provider.

davetropeano commented 7 years ago

The latest version of the IBM Cloud Provider is 0.6.0. IBM Cloud Schematics uses version 0.5.0 currently. The decision was made initially when Schematics went GA that the homepage for the provider docs would align with the homepage of the version of the provider that Schematics is using.

We can revisit this in 1Q2018 relative to other work items