Wiki and tutorial of simple project using gae-boilerplate

[cadusk]

Hey guys, I'm not sure this is the best channel to get in touch.

Is there a guide/tutorial of building a simple app using gae-boilerplate? How about creating a few wiki pages and add sample code to help people gettings started with it?

[peta15]

Welcome!

Have you attempted the "get started in just a few easy steps" section on the github project main page readme? From this you should be able to get the sample site running similar to appengine.beecoss.com. After that you can start adding your own code in the static, templates, and web folders. Anything you want to override in the boilerplate directory can be copied to the folder of the same name on the root directory and modified there.

Let us know if this is enough to get you started. Thanks for joining! On Dec 3, 2012 10:38 AM, "Carlos Cardoso" notifications@github.com wrote:

[cadusk]

Hey Jesse.

Yes, I have gone through the steps and it worked fine locally just as appengine.beecoss.com.

Anyway I think would be useful to users not familiar with appengine (like me) to have a guided tutorial on how to start extending the boilerplate skeleton. Something like the tutorial Django folks have in their documentation site.

I could try to document the steps necessary to build a simple app after having boilerplate setup and running as mentioned on the readme.

[peta15]

Cool ok. How about a simple todo app that where the tutorial shows how to add the model in the datastore, update the config for openid login, add handlers to add, remove, and Mark complete todos, and then push this to production? We can also show how to use the admin page.

If you create the rough draft I would be happy to review it and help if you got stuck. You should join our gae--boilerplate Google group where we can discuss more in depth. On Dec 3, 2012 11:33 AM, "Carlos Cardoso" notifications@github.com wrote:

Hey Jesse.

Yes, I have gone through the steps and it worked fine locally just as appengine.beecoss.com.

Anyway I think would be useful to users not familiar with appengine (like me) to have a guided tutorial on how to start extending the boilerplate skeleton. Something like the tutorial Django folks have in their documentation site.

I could try to document the steps necessary to build a simple app after having boilerplate setup and running as mentioned on the readme.

— Reply to this email directly or view it on GitHubhttps://github.com/coto/gae-boilerplate/issues/220#issuecomment-10960143.

[cadusk]

Well, I wrote a post yesterday introducing myself to the Group but I can't see it. Maybe it is waiting for approval? Anyway... should I start a new topic regarding our tutorials suggestion?

[peta15]

this thread is fine

On Tue, Dec 4, 2012 at 8:00 AM, Carlos Cardoso notifications@github.comwrote:

Well, I wrote a post yesterday introducing myself to the Group but I can't see it. Maybe it is waiting for approval? Anyway... should I start a new topic regarding our tutorials suggestion?

— Reply to this email directly or view it on GitHubhttps://github.com/coto/gae-boilerplate/issues/220#issuecomment-10995520.

[peta15]

here are examples of a todo program we could replicate for our tutorial (of course it wouldn't be realtime... but the point is it is very simple and demonstrates core features)

http://addyosmani.github.com/todomvc/

we would need controllers to:

add todos clear todos save todos view all, complete, incomplete access saved todos via a dashboard after logging in (demonstrate authentication and how to restrict access to permissioned users)

[krismcfarlin]

Before starting a project using spine.js I used the todomvc example it was an excellent starting point for me to start learning how to use spine. I think this would be a great addition for the project. Has anyone started working on this?

[peta15]

Very cool. I think the goal here is to not use Javascript so as to demonstrate how to do a Todo project using handlers and models from gaeb. That being said we could do two versions. One without js and the other integrating a Todomvc project out of the box using a couple gaeb handlers for persisting and loading json that saves the state of the todo js app. On Dec 9, 2012 2:25 AM, "krismcfarlin" notifications@github.com wrote:

Before starting a project using spine.js I used the todomvc example it was an excellent starting point for me to start learning how to use spine. I think this would be a great addition for the project. Has anyone started working on this?

— Reply to this email directly or view it on GitHubhttps://github.com/coto/gae-boilerplate/issues/220#issuecomment-11168475.

[kevlyons]

Hi everybody. I'm with cadusk. I went through the appengine tutorials and thought to myself, "This is good to get the basics but I don't want to build a proper app this way". I searched and found GAE boilerplate, downloaded it, got the local running and then went looking for examples. ;-(

It is a fantastic start and I really want to use it.

I would really like to see some worked examples, please. Even if you just drip feed them as you do them rather than waiting for a complete example.

Thx.

[cadusk]

I like @peta15's idea of mimicking http://addyosmani.github.com/todomvc/ to build a simple gaeb extension scenario.

Along with the crud controllers we'll also need a model class, that I believe could be as simple as todomvc's with title and done fields. Also main page customization will be necessary.

I'm not very sure where to put all this in current project structure to prevent the official boilerplate cluttering.

[kevlyons]

How about just doing a tutorial1, tutorial2 etc in the web folder to get the code sorted, but document in the github wiki. Sorry if that sounds very basic but I'm keen to get some stuff. Like:

1. How to view a model (create a model first, then view Read)
2. How to get data into the model (view to Create)
3. How to update model (view to Update)
4. How to hook into the security services.
5. More complex model (relationships)
6. More complex views (ie. master / detail, trees etc)

Appreciate any links to other resources that would help.

[peta15]

Hi sorry there isn't much movement on the project and this issue right now. Everyone's out for the holidays including me. I'll help with this in a couple weeks. In the meantime checkout the framework docs at http://webapp-improved.appspot.com/ and of course google app engine docs.