Revamp docs, provide better composition utilities #936
Conversation
|
|
🦋 Changeset detectedLatest commit: 64ae254 The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
|
Estimated impact to a consuming app, depending on which bundle is imported
|
Preview URLsreadme: https://3fa64162.ember-resources.pages.dev |
docs/docs/resources.md
Outdated
| }); | ||
| ``` | ||
|
|
||
| To see this code in action, [checkout the live demo](https://limber.glimdown.com/edit?c=MQAggiDKAuD2AOB3AhtAxgCwFBbbAJgKYgBmhAdmsdMgOYDOIay5IARsQK72H4hwh8ASwBOhNNAA2ATxBjyREU1gBbeLHIVo9ADRZkjRIUmSQBuRUX8MxPERD1yQ%2BPELRrxSUIButgn5VCRhIRVQA6HAB5eGghDXoALhwAWhAAAy9fNJBUgH15RUYhVnhJZCpcrFSMn2J4MW8hQkRs-MtCESKSsqodEFLy4toPB1hOESozEmgOkcziAo7K6vn%2BhqbEdmNYFpA2hQ6u-p7CPoG0IbnaiwOlDkkdkfoxicJKrDTP2gArRnmsIRqWAidwAbwsz3GvSYxlMAF9SKEVCAAOSEFQcETJMSQ170FEAbhwhAAHuoQcpyPR3AA5R4AXghLyoAAoWeCNCA4QBKED0gB8IFBWBAlOpIHIDJhJhZABFUIQwpLECzudyiSARWL3LFAkpGTxoABJcgzETeZCSNm8gVCrWi5VhQ1yhVKnaq9VankarUaMJoSSEFiceDWvmC4Wi0UBoMiE1mi1W3UdT2i71arViaDjVjKonpnAAHhmajKM35WqN7iEiRAxcBhH5oNBdMQcLhhYA9MmK12SwNyx9PkA&format=glimdown). |
There was a problem hiding this comment.
This demo doesn't work:
Also, it's unclear to me what the "options" it is talking about are.
There was a problem hiding this comment.
demo will work when the PR is merged 😅 -- because it implements the needed feature where Cells are directly renderable (via the smallest helper manager ever 🎉 ) (( and when the limber repl is updated as well ))
There was a problem hiding this comment.
Also, it's unclear to me what the "options" it is talking about are.
hm, yeah, it's a little orthogonal -- but it's how to use code fences on https://limber.glimdown.com -- maybe that should be removed and extracted to a separate set of docs
docs/docs/resources.md
Outdated
| }); | ||
| ``` | ||
|
|
||
| To see this code in action, [checkout the live demo](https://limber.glimdown.com/edit?c=MQAggiDKAuD2AOB3AhtAxgCwFBbbAJgKYgBmhAdmsdMgOYDOIay5IARsQK72H4hwh8ASwBOhNNAA2ATxBjyREU1gBbeLHIVo9ADRZkjRIUmSQBuRUX8MxPERD1yQ%2BPELRrxSUIButgn5VCRhIRVQA6HAB5eGghDXoALhwAWhAAAy9fNJBUgH15RUYhVnhJZCpcrFSMn2J4MW8hQkRs-MtCESKSsqodEFLy4toPB1hOESozEmgOkcziAo7K6vn%2BhqbEdmNYFpA2hQ6u-p7CPoG0IbnaiwOlDkkdkfoxicJKrDTP2gArRnmsIRqWAidwAbwsz3GvSYxlMAF9SKEVCAAOSEFQcETJMSQ170FEAbhweHI9HcJGBKlQMyUAF4QJpNgBJchSMIAEVQhAAKoDCAAxSmoAAUACIKMkAKqQUV9UFYEAgDAvBIgUXkTiBERCNCyhUgFTFTgzVXqzUdHV6xU8En4U0arWWvSK5XjACMACZVSRkJIeHo4QBKIm4eLuGAIFDoDAgek4l5UYXC8EaEBB2MAPhA8sVJLJ-D5sZhJmFjJAnJmwsDwf1efcxRp3l9RZ40BZjd9ScDmYLgTCaHG8nc9LLFcIVb6boADDOa-qNP3JIQWJx4F2e2gl8gRO2Ok3JMKG3vfdWQ4qxNBxqwqz2c4rlKT3ORHvTYn2ByIh2f7xer6QhdANJhBSIhUtApY7DWipwlgQYhgAPDMahlDMGb6ky9aJCAiF8hmoKghGSCoJgcJwvBAD0b6EGhFFIQMqEfJ8QA&format=glimdown). |
There was a problem hiding this comment.
This one works, but I still don't understand the options.
|
|
||
| Resources can do more than represent data like a ticking clock. You can use a resource with any long-running process, as long as you can represent it meaningfully as a "current value". | ||
|
|
||
| <details><summany>Compared to other systems: Destiny of Unused Values</summary> |
NullVoxPopuli
force-pushed
the
better-composition
branch
from
18f5375 to
6246a3c
Compare
…e consusmer's environemnt
Docs
Quick links to rendered versions
TODOs
(yes, any reactive state can be used within, around, and passed to a resource, but ember has not had a good enough primitive -- so that's where cell steps in -- tracked could be thought of as a wrapper around a cell)
why do we care about them being more portable?
Some TypeScript sins for reference