Skip to content

Conversation

@Oxyjun
Copy link
Contributor

@Oxyjun Oxyjun commented Oct 25, 2024

Summary

1. Improved the Overview page.
- Added "What is a Durable Object?". Lifted paragraphs from this blog post.
- Added "Utilize Durable Objects". Lifted one paragraph from the blog post.

- Added "Get started" button.
2. Added glossary tooltips across the docs.
3. Moved Changelog out of "Platform", and into its own item.
4. Moved up REST API link to sit under "Runtime API".
5. Moved Glossary into "Reference".

The full restructure can be tackled in a separate PR to even out the review burden.

Screenshots (optional)

Documentation checklist

  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

Moving Changelog out of Platform into its own item.
Moving Glossary into Reference.
Updating Changelog YAML with new Changelog location.
@Oxyjun Oxyjun requested review from a team, elithrar, joshthoward and vy-ton as code owners October 25, 2024 17:00
@Oxyjun Oxyjun added the product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ label Oct 25, 2024
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Oct 25, 2024

Deploying cloudflare-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 19c3043
Status: ✅  Deploy successful!
Preview URL: https://f05011be.cloudflare-docs-7ou.pages.dev
Branch Preview URL: https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev

View logs

@github-actions
Copy link
Contributor

This PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:

  • /durable-objects/platform/changelog/
  • /durable-objects/glossary/

@github-actions
Copy link
Contributor

github-actions bot commented Oct 25, 2024

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/durable-objects/observability/graphql-analytics/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/observability/graphql-analytics/
https://developers.cloudflare.com/durable-objects/best-practices/access-durable-objects-storage/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/best-practices/access-durable-objects-storage/
https://developers.cloudflare.com/durable-objects/api/alarms/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/alarms/
https://developers.cloudflare.com/durable-objects/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/
https://developers.cloudflare.com/durable-objects/best-practices/error-handling/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/best-practices/error-handling/
https://developers.cloudflare.com/durable-objects/api/namespace/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/namespace/
https://developers.cloudflare.com/durable-objects/api/stub/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/stub/
https://developers.cloudflare.com/durable-objects/examples/build-a-rate-limiter/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/examples/build-a-rate-limiter/
https://developers.cloudflare.com/durable-objects/examples/websocket-server/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/examples/websocket-server/
https://developers.cloudflare.com/durable-objects/api/id/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/id/
https://developers.cloudflare.com/durable-objects/api/state/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/state/
https://developers.cloudflare.com/durable-objects/api/storage-api/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/storage-api/
https://developers.cloudflare.com/durable-objects/api/websockets/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/api/websockets/
https://developers.cloudflare.com/durable-objects/best-practices/create-durable-object-stubs-and-send-requests/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/best-practices/create-durable-object-stubs-and-send-requests/
https://developers.cloudflare.com/durable-objects/demos/ https://jun-do-docs-enhancement-part.cloudflare-docs-7ou.pages.dev/durable-objects/demos/

@Oxyjun Oxyjun merged commit 356cab8 into production Oct 31, 2024
13 checks passed
@Oxyjun Oxyjun deleted the jun/do/docs-enhancement-part-1 branch October 31, 2024 15:59
elithrar pushed a commit that referenced this pull request Nov 6, 2024
* Adding glossary terms for DO where relevant.

* Lifting text from the Blog to define DO, adding one paragraph which talks about the strength of DO.

* Moving the Glossary into "Reference" section.

* General reordering of sidebar.
Moving Changelog out of Platform into its own item.
Moving Glossary into Reference.
Updating Changelog YAML with new Changelog location.

* Adding redirects.

* Adding missing /

* Reverting Overview text for now.
harshil1712 pushed a commit that referenced this pull request Dec 3, 2024
* Adding glossary terms for DO where relevant.

* Lifting text from the Blog to define DO, adding one paragraph which talks about the strength of DO.

* Moving the Glossary into "Reference" section.

* General reordering of sidebar.
Moving Changelog out of Platform into its own item.
Moving Glossary into Reference.
Updating Changelog YAML with new Changelog location.

* Adding redirects.

* Adding missing /

* Reverting Overview text for now.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:durable-objects Durable Objects: https://developers.cloudflare.com/workers/learning/using-durable-objects/ size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants