Offline Docs

[gewenyu99]

Doc Idea

This is a more involved feature and will change how you write your app when it's enabled. The Offline docs need to guide users through a story to understand if they should use Appwrite Offline and what problems they need to consider.

Outline

• Introduction (describe Appwrite Offline, no heading)
• When Should I Enable Offline? (Describe what problems this solves)
• Configuring Offline
• Configuring Offline: Enabling Offline
• Configuring Offline: Configuring Cache (Mention LRU behavior)
• Promise Resolution (describe how to handle promise resolution) (UML diagram from Steven)
• Conflict Resolution

https://github.com/appwrite/homepage/pull/214

[stnguyen90]

Hmm...I'm worried the "introduce the idea that API calls can become blocking" part might be lost/overlooked. I think this concept is really important, so they need to really know this early on before trying to use t.

[gewenyu99]

Hmm...I'm worried the "introduce the idea that API calls can become blocking" part might be lost/overlooked. I think this concept is really important, so they need to really know this early on before trying to use t.

I will introduce it in the Should I Enable Offline? section. The complexities of enabling offline should be briefly mentioned there + link to lower in the page (?)

[gewenyu99]

It's mostly done. Waiting on screenshots from @stnguyen90

[stnguyen90]

It's mostly done. Waiting on screenshots from @stnguyen90

@gewenyu99, do you mean the diagrams? Where do you want them to go?

[gewenyu99]