diff options
author | Joe Hand <joe@joeahand.com> | 2016-12-17 13:45:55 -0800 |
---|---|---|
committer | Joe Hand <joe@joeahand.com> | 2016-12-17 13:45:55 -0800 |
commit | adb60ff86356115aa0050aea989bdd92fc9fbb45 (patch) | |
tree | 3967d73aba9c7216cf2c5af7c1d2b1474f0bfb47 /README.md | |
parent | 9f6845205ff124c3e99ed6f72167c3585e7f22cc (diff) | |
download | dat-docs-adb60ff86356115aa0050aea989bdd92fc9fbb45.tar.gz dat-docs-adb60ff86356115aa0050aea989bdd92fc9fbb45.zip |
autodeploy on deploy branch. update readmes
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 33 |
1 files changed, 9 insertions, 24 deletions
@@ -8,46 +8,31 @@ Repository for the documentation of the Dat Project ecosystem. View the docs at ## Writing & Editing Docs -[See docs folder](docs/readme.md) for information on editing and adding docs. Once you finish editing the docs, follow the update & deploy docs instructions. +[See docs folder](docs/readme.md) for information on editing and adding docs. Once you finish editing the docs, send a PR to the `deploy` branch to get the edits automatically deployed. -## Installation & Usage +## Development -This documentation uses [minidocs](https://www.npmjs.com/package/minidocs). +This documentation uses [minidocs](https://github.com/freeman-lab/minidocs) for layout, [ecosystem-docs](https://github.com/hughsk/ecosystem-docs) to get documentation from other modules, and ideas from [pull-stream-docs](https://github.com/pull-stream/pull-stream-docs) for auto travis deployment. ### Viewing Docs Locally 1. Clone Repository 2. `npm install` 3. `npm run build:local` to build the docs for local viewing +4. `npm run update` to update external modules 4. `npm run start` to view the docs in browser -### Updating & Deploying Docs +### Deployment -1. Clone Repository -2. `npm install` -3. Make documentation edits -4. `npm run deploy` to build docs & deploy to GitHub pages.` - -### Updating External Module Docs - -We use [ecosystem-docs](https://github.com/hughsk/ecosystem-docs) to get documentation from other modules. +Deployment happens automatically via Travis when updates are pushed to the deploy branch. -1. `npm run update` will update the list of repositories and download the latest docs. -2. Deploy! +### NPM Commands -## NPM Commands - -All the npm commands - -* `npm run deploy`: build and deploy to github -* `npm run build:deploy`: build full html pages & css for deployment -* `npm run build:local`: build app & css for local viewing * `npm start`: start budo server to view locally +* `npm update`: update external module readme files +* `npm run build:local`: build app & css for local viewing * `npm run build:css`: build css, runs with both build commands * `npm run watch:css`: watch css live and build:local with changes -* `npm update`: run both update commands -* `npm run update:list` updates the repository list only -* `npm run update:build` downloads the latest readme to the docs folder. * `npm run paper`: create the paper with pandoc ## License |