Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix: Validation for API link #17099

Merged
merged 3 commits into from
Jun 9, 2023
Merged

Fix: Validation for API link #17099

merged 3 commits into from
Jun 9, 2023

Conversation

Dedelweiss
Copy link
Contributor

@Dedelweiss Dedelweiss commented Mar 14, 2023

In this PR:
I change the regular path from ../exception/scala/Foo.html to exception.scala.Foo to use the DRI resolver function.

Context:

I have a Hello World project with a Foo class and a Foo2 object within a package exception.scala
Screenshot 2023-06-07 at 12 45 47

Example 1 (No warning):

Screenshot 2023-06-07 at 15 38 07

Result:

Screenshot 2023-06-07 at 12 50 13 As you can see, as expected there is no warning for these links.

Example 2 (Warnings):

Screenshot 2023-06-07 at 15 41 00

Result:

Screenshot 2023-06-07 at 15 41 13

Fixes: #16695

@Dedelweiss Dedelweiss changed the title WIP: Validation for API link Fix: Validation for API link Mar 15, 2023
@Dedelweiss Dedelweiss marked this pull request as ready for review March 15, 2023 10:06
Copy link
Member

@ckipp01 ckipp01 left a comment

Choose a reason for hiding this comment

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

Thanks for the PR @Dedelweiss. I added a comment in the original issue. It might be good to discuss there a bit first just to ensure we're all on the same page first before digging in.

@Dedelweiss Dedelweiss marked this pull request as draft April 18, 2023 15:13
@Dedelweiss Dedelweiss mentioned this pull request May 12, 2023
4 tasks
@Dedelweiss Dedelweiss marked this pull request as ready for review June 7, 2023 13:43
@Dedelweiss Dedelweiss requested review from ckipp01 and Florian3k June 8, 2023 12:05
@ckipp01 ckipp01 merged commit 2d9eb1c into scala:main Jun 9, 2023
@Kordyjan Kordyjan added this to the 3.4.0 milestone Aug 2, 2023
nicolasstucki added a commit that referenced this pull request Aug 30, 2023
This PR combines #17099 changes with previous link resolver, which fixes
#18285, #18444 and brings down `Unable to resolve link` warnings from 81
to 7.
4 more links are fixed manually in `.md` files, which leaves us with 3
warnings.
Those 3 are references to source code inside `scaladoc.md`:

https://github.com/lampepfl/dotty/blob/45f633d0667c702fa75efcfda91b434bb72f04dc/docs/_docs/contributing/scaladoc.md?plain=1#L77-L87
Those won't work online anyway (unless we link to github), so we might
want change them.
Kordyjan pushed a commit that referenced this pull request Nov 17, 2023
In this PR: 
I change the regular path from `../exception/scala/Foo.html` to
`exception.scala.Foo` to use the DRI resolver function.

## Context:

I have a Hello World project with a `Foo` class and a `Foo2` object
within a package `exception.scala`
<img width="225" alt="Screenshot 2023-06-07 at 12 45 47"
src="https://github.com/lampepfl/dotty/assets/44496264/1d155f81-5910-44b4-be0c-b495cd75e597">


### Example 1 (No warning):

<img width="500" alt="Screenshot 2023-06-07 at 15 38 07"
src="https://github.com/lampepfl/dotty/assets/44496264/cf341967-8743-480a-9f35-7c27ed78a691">

### Result:

<img width="800" alt="Screenshot 2023-06-07 at 12 50 13"
src="https://github.com/lampepfl/dotty/assets/44496264/ccea1646-3501-4ad2-b9d0-ee5d8bbac969">
As you can see, as expected there is no warning for these links.

### Example 2 (Warnings):

<img width="500" alt="Screenshot 2023-06-07 at 15 41 00"
src="https://github.com/lampepfl/dotty/assets/44496264/9309a851-24d6-472e-839e-444c0dc58bb6">

### Result:

<img width="800" alt="Screenshot 2023-06-07 at 15 41 13"
src="https://github.com/lampepfl/dotty/assets/44496264/1b8986f9-d06c-4eda-9599-e4f2cc0343f7">

Fixes: #16695
[Cherry-picked 2d9eb1c]
Kordyjan added a commit that referenced this pull request Nov 21, 2023
Backports #17099 to the LTS branch.

PR submitted by the release tooling.
[skip ci]
@Kordyjan Kordyjan modified the milestones: 3.4.0, 3.3.2 Dec 14, 2023
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.

Scaladoc reports broken links that aren't broken
4 participants