Docs Revamp - Key Takeaways from getting started with Offer Up Dapp

[sufyaankhan]

After reviewing "Getting Started" Offer-up dapp, here are changes we need so the Developer journey is smooth.

1. Under docs -> whats Agoric -> Takes you back to the home page
   https://docs.agoric.com/

Solution: This should take you to a single page defining what Agoric is (we are missing this page)

2. Under ZOE heading (left side navigation bar) -> We have 3 attempts to define what actually ZOE is:

• Zoe Overview
• Zoe Offer Safety Enforcement
• Offer Safety

Solution: Deprecate 2 of the 3 pages. Consolidate information in to one.

3. Contract Requirements and Price Authority pages both can be deprecated.

4. In the "Getting Started" section, we forget to formally introduce the "Offer Up" dapp.
   e.g. (something like)
   Your First Agoric Dapp - Offer Up
   Offer Up Dapp allows users to view all listed items up for sale in the marketplace. The Dapp shows 3 items by default. As a user you are able to choose up to 3 quantity of items (in any combination). You can then create an "offer" for an amount more than 0.25 IST. Once you sign the transaction, you will see the 3 items in your wallet and your wallet amount deducted by the Offer amount.

5. In the end of "Getting Started" we should write a small paragraph about what should the developer take away from this exercise:
   e.g. Key Takeaways:
   In this lesson we showed you:
   How to start an Agoric Chain (re-show 1 line code)
   How to deploy a contract (re-show 1 line code)
   How to make an offer.. (re-show 1 line code)

6. Deprecate the page "Synching on Mainnet"

7. Smart Wallet Dapp Architecture - This page needs to be re-written with the vision of "How to build a Client UI"
8. Deploying Smart Contracts page - This should discuss our Offer Up dapp and re-write this page in its context.

Tasks

Beta Give feedback

1. Contract Requirements and Price Authority pages both can be deprecated
2. copy to introduce the "Offer Up" dapp
3. enumerate Key Takeaways from Getting Started
4. Deprecate the page "Synching on Mainnet"

tracked separately:

• Should "What is Agoric" link to company home page?
• 3 overlapping / redundant zoe offer safety pages #918
• How to build a Client UI - document ui-kit #922

[dckc]

Deploying Smart Contracts page - This should discuss our Offer Up dapp and re-write this page in its context.

closely related:

• update permissioned deployment to match dapp-agoric-basics #917

[dckc]

#920 took care of item 4

[kbennett2000]

Item 5 addressed by #926

[kbennett2000]

Item 6 addressed by #925

[dckc]

#964 takes care of contract requirements, price authority (item 3) and enough of #918 for now, so I'm closing this.

For the last item, deployment, we have two other tickets tracking that:

• update permissioned deployment to match dapp-agoric-basics #917
• Docs Revamp - Permissioned Deployments - writeup #961

"What is Agoric?" is perhaps an issue with the docs homepage, but not relevant to key takeaways from getting started.