{"action":"created","issue":{"url":"https://api.github.com/repos/tada/pljava/issues/44","labels_url":"https://api.github.com/repos/tada/pljava/issues/44/labels{/name}","comments_url":"https://api.github.com/repos/tada/pljava/issues/44/comments","events_url":"https://api.github.com/repos/tada/pljava/issues/44/events","html_url":"https://github.com/tada/pljava/pull/44","id":95951455,"number":44,"title":"Enable maven features to build a basic tech-detail site","user":{"login":"jcflack","id":3670696,"avatar_url":"https://avatars.githubusercontent.com/u/3670696?v=3","gravatar_id":"","url":"https://api.github.com/users/jcflack","html_url":"https://github.com/jcflack","followers_url":"https://api.github.com/users/jcflack/followers","following_url":"https://api.github.com/users/jcflack/following{/other_user}","gists_url":"https://api.github.com/users/jcflack/gists{/gist_id}","starred_url":"https://api.github.com/users/jcflack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jcflack/subscriptions","organizations_url":"https://api.github.com/users/jcflack/orgs","repos_url":"https://api.github.com/users/jcflack/repos","events_url":"https://api.github.com/users/jcflack/events{/privacy}","received_events_url":"https://api.github.com/users/jcflack/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-07-19T21:46:05Z","updated_at":"2015-07-21T06:54:13Z","closed_at":"2015-07-21T06:54:03Z","pull_request":{"url":"https://api.github.com/repos/tada/pljava/pulls/44","html_url":"https://github.com/tada/pljava/pull/44","diff_url":"https://github.com/tada/pljava/pull/44.diff","patch_url":"https://github.com/tada/pljava/pull/44.patch"},"body":"Now `mvn clean package site site:stage` will produce a (very basic, uncustomized) directory tree representing a web site under `target/staging`. It includes generated javadocs for everything (and I've also spent a bit of time completing javadocs, at least the ones I noticed missing and felt competent to write).\r\n\r\nIn order to make maven do this, I had to put a site URL into `pom.xml` and you will see that I used `http://tada.github.io/pljava/` which is (I think) what the project's [GitHub Pages](https://help.github.com/articles/creating-project-pages-manually/) URL would be, if you were to enable that feature. So, you may detect in this pull request a faint, implicit suggestion about doing that. :)\r\n\r\nI can see in the repository that there already is a `gh-pages` branch where you did some experimenting in early 2013, but that seems to have been just the same content that is now the wiki. What I would suggest is to keep the wiki, and enable the `gh-pages` site for nothing but maven autogenerated technical docs. User Guide content on the wiki could then link to them when appropriate.\r\n\r\nAlthough I haven't tried it, I believe there is a [GitHub-supplied plugin](https://github.github.com/maven-plugins/site-plugin/site-mojo.html) for maven that completes the process, so that a `mvn` command similar to mine above would build all the docs and put them on the GitHub Pages site.\r\n\r\nWhile I'm not sure how you feel about enabling the GitHub Pages site for that purpose, in any case merging this branch will allow anyone who downloads pljava to run the `mvn` command above and get a local set of the same docs."},"comment":{"url":"https://api.github.com/repos/tada/pljava/issues/comments/123191054","html_url":"https://github.com/tada/pljava/pull/44#issuecomment-123191054","issue_url":"https://api.github.com/repos/tada/pljava/issues/44","id":123191054,"user":{"login":"thallgren","id":209495,"avatar_url":"https://avatars.githubusercontent.com/u/209495?v=3","gravatar_id":"","url":"https://api.github.com/users/thallgren","html_url":"https://github.com/thallgren","followers_url":"https://api.github.com/users/thallgren/followers","following_url":"https://api.github.com/users/thallgren/following{/other_user}","gists_url":"https://api.github.com/users/thallgren/gists{/gist_id}","starred_url":"https://api.github.com/users/thallgren/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thallgren/subscriptions","organizations_url":"https://api.github.com/users/thallgren/orgs","repos_url":"https://api.github.com/users/thallgren/repos","events_url":"https://api.github.com/users/thallgren/events{/privacy}","received_events_url":"https://api.github.com/users/thallgren/received_events","type":"User","site_admin":false},"created_at":"2015-07-21T06:54:13Z","updated_at":"2015-07-21T06:54:13Z","body":"This is excellent. Thanks!"}}