Document Development mode

[rymsha]

In a few places documentation mentions XP development mode. For instance https://developer.enonic.com/docs/enonic-cli/master#deploy

But Development mode is not explained:

• What is it for?
• When (not) to use it?
• What does it do?

[thomasheartman]

Does this concern the XP docs or the CLI docs? Both? #247 is similar to this, but only concerns the XP docs. It's also more about the difference between dev mode and continuous builds.

If this is about the XP docs, are the changes introduced in #248 sufficient?

Edit

I see now that this is is mentioned in enonic/xp#8117:

To sum up

• it always (often unnecessarily) slows down page loading/rendering in dev mode
• it modifies XP behavior between dev and prod mode
• it does not always work
• it requires a bit extra code testing and support
• it has a robust alternative

As such, this probably needs some extra documentation. If what's listed above is all that's necessary, I'm happy to give it a go 🙋🏾

[rymsha]

• What is it for? I think it is covered

• When (not) to use it? Big red warning should exist in docs, that development mode is not for production. It is not only a performance concern, but also a security concern.

• What does it do? I think, there is a mistake in your latest changes. Development mode does not redeploy apps. Instead it:

• disables some cache mechanisms in XP

• reads resources directly from source locations

[thomasheartman]

Got it! Thanks for the feedback and for clearing up how dev mode works! I'll go and make sure to correct it and add the warning about production use 👍🏾

[alansemenov]

Will be fixed in https://github.com/enonic/doc-xp/issues/247