Merge pull request #658 from buildpacks/refactor-rfc

Implement refactor rfc

.gitignore

@@ -17,7 +17,7 @@ $RECYCLE.BIN/
 *.iml
 
 # Generated files
-content/docs/tools/pack/cli/pack*
+content/docs/for-platform-operators/how-to/integrate-ci/pack/cli/pack*
 
 # Hugo
 .hugo_build.lock

Makefile

@@ -108,9 +108,9 @@ install-ugo:
 .PHONY: pack-docs-update
 pack-docs-update: upgrade-pack
 	@echo "> Updating Pack CLI Documentation"
-	@echo "> SHA of contents (before update):" `find ./content/docs/tools/pack -type f -print0 | xargs -0 sha1sum | sha1sum | cut -d' ' -f1`
+	@echo "> SHA of contents (before update):" `find ./content/docs/for-platform-operators/how-to/integrate-ci/pack -type f -print0 | xargs -0 sha1sum | sha1sum | cut -d' ' -f1`
 	cd tools; go run -mod=mod get_pack_commands.go
-	@echo "> SHA of contents (after update):" `find ./content/docs/tools/pack -type f -print0 | xargs -0 sha1sum | sha1sum | cut -d' ' -f1`
+	@echo "> SHA of contents (after update):" `find ./content/docs/for-platform-operators/how-to/integrate-ci/pack -type f -print0 | xargs -0 sha1sum | sha1sum | cut -d' ' -f1`
 
 .PHONY: pack-version
 pack-version: export PACK_VERSION:=$(PACK_VERSION)

content/community.md

@@ -35,7 +35,7 @@ If you didn't find anything you'd like to improve while going through the tutori
 [talks]: /docs/#talks
 [tutorials]: /docs/#tutorials
 [spec]: /docs/reference/spec/
-[platforms]: /docs/concepts/components/platform/
+[platforms]: /docs/for-app-developers/concepts/platform/
 [pack]: https://github.com/buildpacks/pack
 [lifecycle]: https://github.com/buildpacks/lifecycle
 [docs]: https://github.com/buildpacks/docs

content/docs/_index.md

@@ -13,27 +13,23 @@ summary="Get started with Cloud Native Buildpacks."
 ## Tutorials
 
 * [An App’s Brief Journey from Source to Image](/docs/app-journey/) - An easy-to-follow introduction to Cloud Native Buildpacks using `pack`, a command line tool for Cloud Native Buildpacks.
-* [Creating a Cloud Native Buildpack](/docs/buildpack-author-guide/create-buildpack) - Tutorial walking through the creation of a simple Ruby buildpack.
+* [Creating a Cloud Native Buildpack](/docs/for-buildpack-authors/tutorials/basic-buildpack) - Tutorial walking through the creation of a simple Ruby buildpack.
 
-## [Concepts](/docs/concepts)
+## Going deeper
 
-Learn the [concepts](/docs/concepts) of Cloud Native Buildpacks.
+See how-to guides, concepts, and tutorials tailored to specific personas:
 
-## Guides
+*  [App Developers](/docs/for-app-developers/)
+*  [Buildpack Authors](/docs/for-buildpack-authors/)
+*  [Operators](/docs/for-platform-operators/)
 
-Set of guides tailored to specific personas:
+## [Tools](/docs/for-platform-operators/)
 
-*  [App Developers](/docs/app-developer-guide/)
-*  [Buildpack Authors](/docs/buildpack-author-guide/)
-*  [Operators](/docs/operator-guide/)
-
-## [Tools](/docs/tools/)
-
-* **[CircleCI](/docs/tools/circleci)** - {{< summary "/docs/tools/circleci" >}}
-* **[GitLab](/docs/tools/gitlab)** - {{< summary "/docs/tools/gitlab" >}}
-* **[kpack](/docs/tools/kpack)** - {{< summary "/docs/tools/kpack" >}}
-* **[Pack](/docs/tools/pack)** - {{< summary "/docs/tools/pack" >}}
-* **[Tekton](/docs/tools/tekton)** - {{< summary "/docs/tools/tekton" >}}
+* **[CircleCI](/docs/for-platform-operators/how-to/integrate-ci/circleci)** - {{< summary "/docs/for-platform-operators/how-to/integrate-ci/circleci" >}}
+* **[GitLab](/docs/for-platform-operators/how-to/integrate-ci/gitlab)** - {{< summary "/docs/for-platform-operators/how-to/integrate-ci/gitlab" >}}
+* **[kpack](/docs/for-platform-operators/how-to/integrate-ci/kpack)** - {{< summary "/docs/for-platform-operators/how-to/integrate-ci/kpack" >}}
+* **[Pack](/docs/for-platform-operators/how-to/integrate-ci/pack)** - {{< summary "/docs/for-platform-operators/how-to/integrate-ci/pack" >}}
+* **[Tekton](/docs/for-platform-operators/how-to/integrate-ci/tekton)** - {{< summary "/docs/for-platform-operators/how-to/integrate-ci/tekton" >}}
 
 ## [Reference](/docs/reference/)
 

content/docs/app-journey.md

@@ -99,9 +99,9 @@ deploying your new image to your favorite cloud!
 
 Windows image builds are now supported!
 
-<a href="/docs/app-developer-guide/build-a-windows-app" class="button bg-blue">Windows build guide</a>
+<a href="/docs/for-app-developers/how-to/special-cases/build-for-windows" class="button bg-blue">Windows build guide</a>
 
-[builder]: /docs/concepts/components/builder/
-[buildpack]: /docs/concepts/components/buildpack/
+[builder]: /docs/for-platform-operators/concepts/builder/
+[buildpack]: /docs/for-platform-operators/concepts/buildpack/
 [samples-java-maven]: https://github.com/buildpacks/samples/tree/main/apps/java-maven
 [pack-docs]: /docs/tools/pack/