guides-source icon indicating copy to clipboard operation
guides-source copied to clipboard

"Later on" comment feels confusing in "Native classes in-depth" section

Open jacobq opened this issue 3 years ago • 3 comments

In the Native Classes In-Depth part of the guides it says:

Ember provides a number of decorators, such as the @tracked decorator, that will be described in greater detail later on in the guides.

but it's not obvious to me where "later on in the guides" is because this is the end of the in-depth topics section which is the end of the core concepts guide. The Autotracking In-Depth page 3 topics back talks about it though as does Component State and Actions (even earlier), and the Tracked Properties page (in the octane upgrade guide in the additional resources list way at the end). I think it would be nice if there could be some kind of cross-reference here or perhaps just removal of the phrase "later on" as this seems misleading to me if the left navigation can be taken as a topologically accurate representation of the linear flow of the guides.

Side-note: I actually stumbled across this page because I was looking for a section about computed macros like alias, filterBy etc. (not sure where this went, if that's no longer encouraged, etc.) and found them in the API docs instead

jacobq avatar Jun 09 '21 22:06 jacobq

I agree, this should be a link.

Ember provides a number of decorators, such as the [@tracked decorator](link to auto tracking).

jenweber avatar Aug 13 '21 15:08 jenweber

Thanks for the feedback and suggestion!

jenweber avatar Aug 13 '21 15:08 jenweber

I will work on this issue. @jenweber

rajakvk avatar Aug 13 '21 15:08 rajakvk

Hi there! Can this issue be closed? It looks like the PR to fix it was merged in already.

jonr-luma avatar Oct 04 '22 16:10 jonr-luma