Create "publish" make target to replace migrations-php.yaml

Author: jmikola

.gitmodules

@@ -0,0 +1,4 @@
+[submodule "build/php-library"]
+	path = build/php-library
+	url = https://github.com/mongodb/mongo-php-library.git
+	branch = master

Makefile

@@ -6,18 +6,24 @@ STAGING_BUCKET=docs-mongodb-org-staging
 PRODUCTION_BUCKET=docs-mongodb-org-prod
 PREFIX=php-library
 
-.PHONY: help stage fake-deploy deploy
+.PHONY: help publish stage fake-deploy deploy
 
 help:
 	@echo 'Targets'
 	@echo '  help         - Show this help message'
+	@echo '  publish      - Publish docs locally'
 	@echo '  stage        - Host online for review'
 	@echo '  fake-deploy  - Create a fake deployment in the staging bucket'
 	@echo '  deploy       - Deploy to the production bucket'
 	@echo ''
 	@echo 'Variables'
 	@echo '  ARGS         - Arguments to pass to mut-publish'
 
+publish:
+	git submodule update --init
+	rsync -a --delete build/php-library/docs/ source/
+	giza make publish
+
 stage:
 	mut-publish build/${GIT_BRANCH}/html ${STAGING_BUCKET} --prefix=${PREFIX} --stage ${ARGS}
 	@echo "Hosted at ${STAGING_URL}/${PREFIX}/${USER}/${GIT_BRANCH}/index.html"

README.rst

@@ -15,9 +15,9 @@ the following command: ::
 
      git clone git://github.com/mongodb/docs-php-library
      cd docs-php-library/
-     giza make html
+     make publish
 
-View ``build/html/index.html`` to view your current build of the
+View ``build/master/index.html`` to view your current build of the
 documentation.
 
 If you have not installed giza, you can do so with `pip`.

build/php-library

@@ -21,14 +21,10 @@ system:
     - 'sphinx_local.yaml'
     - 'push.yaml'
     - htaccess: ['htaccess.yaml']
-    - migrations: 'migrations-php.yaml'
 assets:
   - branch: master
     path: build/docs-tools
     repository: http://github.com/mongodb/docs-tools.git
-  - branch: master
-    path: build/php-library # this is where we'll put the source docs (from the driver repo)
-    repository: https://github.com/mongodb/mongo-php-library.git
 paths:
   output: 'build'
   source: 'source'