Add py and feature file in installation docs

[behave]

Add py and feature file in installation docs

[bittner]

In fact, there is no difference. You do not need any additional setup apart from adding behave_django to your INSTALLED_APPS (see the Installation chapter). The example for features, steps, environment would be just what the behave docs show. Plus optional goodies from the Usage chapter, naturally.

If you feel there is a full-blown example missing, please fork the repo, adapt the docs, and place a pull request.

We could in theory also maintain a list of good examples, open source projects that use (and do a good job using) behave-django.

[bittner]

The files mentioned (and used for the demo output) in the Installation chapter are actually the ones in the features/ folder of our repository:

• features/environment.py
• features/running-tests.feature
• features/steps/running_tests.py

All the files in this folder serve as useful examples (see context-urlhelper.py, for example). Maybe we should mention that and link to them from the docs?

[sih4sing5hong5]

Adding links for the above three files is enough.

All the files in this folder serve as useful examples (see context-urlhelper.py, for example).
The docs can mention and link this.
More examples is better.

[bittner]

I think we will link (back) to the Django chapter of the behave docs, once PR 429 is merged. This will make using behave-django much clearer. Without adding explanations that are already provided by the behave docs. And in addition we can link to our source code from the docs, as discussed above.

More examples is better.

What do you think about adding Django examples to the behave/behave.example repository? Please, do that! Everybody will appreciate your contribution.

[bittner]

@mixxorz Can you re-generate the docs once the PR on the behave docs is merged + their docs published?

[mixxorz]

@bittner Sure thing

[mixxorz]

I've rebuilt and uploaded the docs!

https://pythonhosted.org/behave-django/

I'll open up another issue regarding migrating to Read The Docs (for automated doc builds).