Skip to content

Commit

Permalink
Documented a couple of pain points.
Browse files Browse the repository at this point in the history
  • Loading branch information
gcv committed Nov 9, 2010
1 parent c4c2430 commit 6d69583
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions README.md
Expand Up @@ -89,6 +89,10 @@ resulting project, but do take a careful look at it. In particular, you should
avoid checking in `resources/WEB-INF/lib/` or `resources/WEB-INF/classes/`: let
Leiningen take care of managing those directories.

NB: When editing the Leiningen `project.clj` file, do not point `:compile-path`
or `:library-path` to `resources/WEB-INF/classes/` and
`resources/WEB-INF/lib/`. This will interfere with deployment.


### Development process

Expand Down Expand Up @@ -321,6 +325,19 @@ A few simple examples:
## Limitations


### Using App Engine API calls

Most App Engine services do not work when invoked without an initialized App
Engine context. For the time being, this context only exists (1) inside an
application's Ring handlers, and (2) in the automatic testing environment
provided by `appengine-magic.testing`. This means that you cannot directly
invoke most App Engine API functions from the REPL.

This limitation will be addressed in the future. (In the meanwhile, avoid tight
coupling between your application code and App Engine services.)



### Incomplete features

When using the interactive REPL environment, some App Engine services are more
Expand Down

0 comments on commit 6d69583

Please sign in to comment.