Skip to content

Use gitbook for docs#941

Merged
ssalinas merged 8 commits into
masterfrom
gitbook
Mar 17, 2016
Merged

Use gitbook for docs#941
ssalinas merged 8 commits into
masterfrom
gitbook

Conversation

@ssalinas

Copy link
Copy Markdown
Contributor

Reorganizing docs and displaying using gitbook. Eventual goal is be able to replace our github pages page with gitbook generated site.

ToDo:

  • Setup page with details for each release (like we have for 0.4.9 on the wiki). Fill out relevant details back to at least 0.4.5
  • Write more examples and docs for use of specific features, organize these in a folder so they can be pulled in in other locations by the gitbook
  • Update the ui page with more recent screenshots
  • Double check examples page and update to use an org repo
  • One more pass over all docs to be sure everything is up to date (examples are working, etc)

if you want to view the current state of the docs, on this branch you can npm install -g gitbook and run gitbook serve. Docs should be available on localhost:4000

@ssalinas ssalinas changed the title (WIP) use gitbook for docs Use gitbook for docs Mar 14, 2016
@ssalinas

Copy link
Copy Markdown
Contributor Author

Good draft of this is done now, with a bunch of docs added for a few features, releases, updated ui images, etc. Let me know what you think

also thanks @zdhickman for reading it over and fixing small stuff I missed ;)

@ssalinas

Copy link
Copy Markdown
Contributor Author

Some notes on this:

  • Changes to existing docs are just typo fixes, updating links, and a small bit of rewording. Most changes to the actual docs are additions of new docs
  • Created an intro.md which the gitbook uses at its landing page. This is almost the same as the README.md, but I wanted to have the flexibility of the gitbook homepage and README being different
  • Added a script that will build the latests swagger docs and split them up for the gitbook, build the gitbook, replace the favicon, and publish to gh-pages branch so that it is easy to update. This should only include the relevant files since the .bookignore excludes the actual source code

ssalinas added a commit that referenced this pull request Mar 17, 2016
@ssalinas ssalinas merged commit 58dd001 into master Mar 17, 2016
@ssalinas ssalinas deleted the gitbook branch March 17, 2016 16:10
@ssalinas ssalinas modified the milestone: 0.4.12 Apr 1, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant