guides-source

guides-source copied to clipboard

Blockquotes lack styling, existing blockquote usage is incorrect

3

# Problem Summary 1. Blockquotes are unstyled in the guide 2. Many guides currently utilize blockquotes in a semantically incorrect way **Example _screenshot_ where the second paragraph is a blockquote:**...

hergaiety

Show how to generate a unique ID to use with input labels

3

After https://github.com/ember-learn/guides-source/pull/1365 is merged, I think we should show how to use guidFor to generate the ID. There is a good example in the Ember Octane Cheatsheet https://ember-learn.github.io/ember-octane-vs-classic-cheat-sheet/

jenweber

WIP - Create a dedicated section on application data flow/requests

2

This topic is still under discussion and isn't ready yet to be picked up by contributors. The goal is to first work out some of the big questions of what...

jenweber

Octane @tracked properties in native classes models do not JSON.stringify

4

declaring models as util classes and using `@tracked` property (as described here https://octane-guides-preview.emberjs.com/release/state-management/tracked-properties/#toc_tracked-properties-in-custom-classes) causes any such model passed to a `JSON.stringify` call to omit any tracked properties from the json...

void-mAlex

Show how to make your own input component

15

In Ember Octane, we have an emphasis on teaching devs how to use Ember to interact with the DOM. We should show an example of how to create a regular...

jenweber

add more explicit documentation for `...attributes`

2

We need to add more examples that clearly define `...attributes` and give several examples for use. - [ ] 2-3 examples of position placement and the outcomes - [ ]...

MelSumner

ember serve vs. yarn/npm run start

4

Just a small inconsistency. The quickstart says ```sh cd ember-quickstart ember serve ``` but my terminal showed ``` 👉 We suggest you that you get started by typing: $ cd...

samselikoff

The [Feature Flags doc](https://github.com/emberjs/ember.js/blob/master/FEATURES.md) and [guide](https://guides.emberjs.com/release/configuring-ember/feature-flags/) indicates that the feature key should be in lowercase dasherize format, but this format is an old format and it is not working anymore....

ppcano

Document @action async foo()

5

`@action async foo() {}` seems like a really nice way to write code, but there are some gotchas that should be documented. Probably should go here: https://guides.emberjs.com/release/components/component-state-and-actions/ Following a discussion...

mehulkar

Optional feature documentation should display expected values per Edition

1

Since the values of each optional feature depend on which edition the application is on, we should make sure the documentation displays such information.

locks