Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

First cut at a getting started guide which is more useful than what we had #208

Merged
merged 12 commits into from
Apr 2, 2014

Conversation

jsuereth
Copy link
Member

@jsuereth jsuereth commented Apr 1, 2014

Trying to reorganize the website so that it's easier to get into the native packager and figure things out.

I need some help here. Spent a good bit of time on this first part to try to get it right. I think this may be enough of a start for some help. This is the last thing holding up the 0.7.0 release.

Review by @muuki88

jsuereth added 3 commits April 1, 2014 10:44
* Complete first cut of configuration section.
* Lay out the next two sections.
* Enable ~ to work for sphinx tasks
* Rework the flow a bit
* Add the first section on mappings to the getting started guide.
* Configuring the JVM and the process
* Configuring the Application itself.

The native packager provides a direct hook into the generated scripts for JVM configuration. Let's make use of this. First, add the following to the ``src/universal/conf/jvmopts`` file in the project ::
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, I didn't come across this option yet. What should we enforce? src/templates/etc-default or the jvmopts ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, in this context this is not for a server but a client. So... I think it's ok.

I was planning to have a section on servers (which I think are more complicated starting out) later. WDYT?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, that totally makes sense. Splitting in two sections I think is the way to go.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done. I'll push the update shortly.

@muuki88
Copy link
Contributor

muuki88 commented Apr 1, 2014

Overall this looks pretty good. Step-by-step is always nice, however living example projects are always helpful on your way. I'm currently trying to build some here, but I have no good idea how to integrate them inside the docs.

I'm a bit confused of all the possibilities to change the jvm and application parameters :D

  • bashScriptExtraDefines
  • src/universal/conf/jvmopts
  • src/templates/etc-default

IMHO we should point out the differences or remove duplicated ways of doing things.

@jsuereth
Copy link
Member Author

jsuereth commented Apr 2, 2014

Yeah, I guess let me think about that a bit. MAYBE we need two paths of docs:

Getting started with Applications
Getting started with Servers

Because things differ slightly....

@jsuereth
Copy link
Member Author

jsuereth commented Apr 2, 2014

@muuki88 - Completed the getting started with Applications guide (I think). Comments welcome.

I may need help with the server side, but I'll see what I can tackle shortly.

@muuki88 muuki88 added the docs label Apr 2, 2014
@muuki88 muuki88 added this to the 0.7.0 - Server archetype milestone Apr 2, 2014
@muuki88
Copy link
Contributor

muuki88 commented Apr 2, 2014

I think we can merge this one and add new stuff in a new PR

@jsuereth
Copy link
Member Author

jsuereth commented Apr 2, 2014

k, let me remove the copyright quick :)

@jsuereth
Copy link
Member Author

jsuereth commented Apr 2, 2014

well, have it not be just me, at least!

* Bump to new sbt-site plugin with ~ support directly
* remove Josh Suereth as only copyright holder.
@jsuereth
Copy link
Member Author

jsuereth commented Apr 2, 2014

Ok, ready for merge now. I'm going to issue a 0.7.0-RC2 off master once this is in.

muuki88 added a commit that referenced this pull request Apr 2, 2014
First cut at a getting started guide which is more useful than what we had
@muuki88 muuki88 merged commit 2ccecc9 into master Apr 2, 2014
@muuki88 muuki88 deleted the wip/getting-started-guide branch April 2, 2014 20:50
@muuki88
Copy link
Contributor

muuki88 commented Apr 2, 2014

Sorry for letting you wait :(

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Documentation should be extended or updated
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants