Media Path as Objects - Documentation fix and usage example

[Leandro de Souza]

Related conversation on forum: ​https://forum.djangoproject.com/t/media-path-as-objects/28470

Issue: The documentation for Media Path as Objects ​https://docs.djangoproject.com/en/4.1/topics/forms/media/#paths-as-objects uses an incorrect attribute (rel) on a script tag, source: HTML attribute: rel - HTML: HyperText Markup Language | MDN ​https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel. Quoted from the source:

The rel attribute defines the relationship between a linked resource and the current document. Valid on <link>, <a>, <area>, and <form>, the supported values depend on the element on which the attribute is found.

Another thing is that the example given for the usage of this new feature added on 4.1 is not really that useful. The JSPath class in the example is just a hardcoded script tag that illustrates how to use the __str__ method to render the tag.

I believe that adding a more useful example would add more "bright" to the value that this feature has providen: adding flexibility. Some usage examples of this new feature has been added to the conversation on the forum.

I would be happy to work on this patch/fix.

[Carlton Gibson]

As per the discussion, I’ll accept to fix the error with the rel tag.

I’d suggest doing that in an initial commit.

Then, I think there’s some review to be done to judge the “better example” right. (Enough but not too much)

[Leandro de Souza]

After reading the docs on how to submit a patch, i haven't figured it out from which branch should my patch be based. Should it be from the django's "main" branch?

[Leandro de Souza]

Opened the pull request ​https://github.com/django/django/pull/17926 for the initial patch.
Waiting for new directives about the more "detailed" examples mentioned.
Cheers and thanks!

[GitHub <noreply@…>]

In 368a8a3:

Fixed #35261 -- Corrected Media JS example of object-based paths in docs.

rel attribute is not valid on <link> tags.

[Mariusz Felisiak <felisiak.mariusz@…>]

In 17855bf:

[5.0.x] Fixed #35261 -- Corrected Media JS example of object-based paths in docs.

rel attribute is not valid on <link> tags.
Backport of 368a8a3a83885a13776a530920f0317a40e7989d from main