Skip to content

Fix broken references to yew_services#1861

Closed
allan2 wants to merge 3 commits into
yewstack:masterfrom
allan2:master
Closed

Fix broken references to yew_services#1861
allan2 wants to merge 3 commits into
yewstack:masterfrom
allan2:master

Conversation

@allan2
Copy link
Copy Markdown
Contributor

@allan2 allan2 commented May 21, 2021

Update the use statement in the Fetch example.
Fix the broken links to Rust docs.

Improve wording.

Update the `use` statement in the Fetch example.
Fix the broken links to Rust docs.

Improve wording.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 21, 2021

Visit the preview URL for this PR (updated for commit a2cdbe3):

https://yew-rs--pr1861-master-jn2j27o8.web.app

(expires Fri, 28 May 2021 19:25:37 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

@allan2
Copy link
Copy Markdown
Contributor Author

allan2 commented May 21, 2021

This PR consists only of minor doc fixes in .md files.

The failing check is not related.

Comment thread docs/more/debugging.md Outdated
Comment thread docs/more/debugging.md Outdated
Comment thread docs/more/debugging.md
### [`ConsoleService`](https://docs.rs/yew/latest/yew/services/console/struct.ConsoleService.html)

This service is included within the [`yew-services`](https://crates.io/crates/yew-services) crate:
This service is included with Yew.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Possible improvement?

Suggested change
This service is included with Yew.
This service is defined inside the `yew` crate.

Comment thread docs/more/debugging.md
## Source Maps

There is currently no first-class support for source maps for Rust / Wasm web apps. This, of course, is subject to change. If this is no longer true or if progress is made, please suggest a change!
There is currently no first-class support for source maps for Rust/Wasm web apps. This could change in the future.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe?

Suggested change
There is currently no first-class support for source maps for Rust/Wasm web apps. This could change in the future.
Sadly Rust/Wasm web apps are not properly supported by browsers. Hopefully this will change in the future.

```rust
use yew::format::Nothing;
use yew_services::fetch::Request;
use yew::services::fetch::Request;
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These changes are wrong, since the layout was recently changed and the services are in a separate crate now: https://github.com/yewstack/yew/tree/master/packages/yew-services
Please note that you're editing the documentation for the 'master' branch which contains changes that haven't been published yet.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I definitely missed that.
Shall I remove the yew_services changes and still add the wording changes here in master?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I think the wording changes are great!

@siku2
Copy link
Copy Markdown
Member

siku2 commented May 21, 2021

See also #1728

@ranile
Copy link
Copy Markdown
Member

ranile commented May 21, 2021

It's worth mentioning that yew_services is going away as part of #1842.

@teymour-aldridge
Copy link
Copy Markdown
Contributor

That is awkward. I think that these changes are still worth incorporating though, because much of this documentation will hopefully be repurposed alongside the bits that are moved into gloo.

@ranile
Copy link
Copy Markdown
Member

ranile commented May 21, 2021

I agree. It's worth updating the documentation

allan2 and others added 2 commits May 21, 2021 16:52
Co-authored-by: Teymour Aldridge <42674621+teymour-aldridge@users.noreply.github.com>
Co-authored-by: Teymour Aldridge <42674621+teymour-aldridge@users.noreply.github.com>
@allan2
Copy link
Copy Markdown
Contributor Author

allan2 commented May 21, 2021

I made this PR because I was following the fetch example on 0.18.0 when I noticed the use declaration in the next docs was not working (it referred to yew_services crate).

Just to double-check:

  • yew_services, staying or going away?
  • should docs in master refer to yew crate or yew_services crate?

Cheers

@mc1098
Copy link
Copy Markdown
Contributor

mc1098 commented Jul 16, 2021

yew_services, staying or going away?

yew_services will be gone when #1842 lands.

should docs in master refer to yew crate or yew_services crate?

The yew.rs website is maintained on the master branch for both 'next' and '0.18.0' docs; therefore, changes to documentation of 0.18.0 will be changed on master and not the v18.0 branch of this repo.

On master:

yew.rs version location services reference
0.18.0 website/versioned_docs/version-0.18.0/** refer to services the module within the yew crate
next website/docs/** refer to yew_services the crate (until #1842 lands)

Hope that helps answer the questions :)
I think once you've followed the review suggestions and resolve the conflicts this could be merged 🎉.

@ranile
Copy link
Copy Markdown
Member

ranile commented Aug 14, 2021

yew-services has been removed so this can be closed now.

@siku2 siku2 closed this Sep 5, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants