Bug 570874 - Deprecated API removals page shows gibberish
Summary: Deprecated API removals page shows gibberish
Status: NEW
Alias: None
Product: Platform
Classification: Eclipse Project
Component: UI (show other bugs)
Version: 4.19   Edit
Hardware: PC Windows 10
: P3 critical (vote)
Target Milestone: ---   Edit
Assignee: Platform-UI-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-02-03 07:26 EST by Wim Jongman CLA
Modified: 2021-06-04 00:55 EDT (History)
1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Wim Jongman CLA 2021-02-03 07:26:15 EST 
I again had to search for the API breakage guide because another big eclipse based plugin crashed using an old removed API (JFace Assert)

I have to point them to the API break document so that they can fix the issue. However, that page is unreadable.

It can be reached using the following links: 

somehow find:

https://www.eclipse.org/eclipse/development/readme_eclipse_4.17.php

then click 
1.2.1 Compatibility of Release 4.17 with 4.16 (https://www.eclipse.org/eclipse/development/readme_eclipse_4.17.php#mozTocId324309)

then click 

Eclipse 4.17 Plug-in Migration Guide (https://www.eclipse.org/eclipse/development/porting/eclipse_4_17_porting_guide.html)

Then click
Deprecated API removals in Eclipse Platform(https://git.eclipse.org/c/platform/eclipse.platform.common.git/plain/bundles/org.eclipse.platform.doc.isv/porting/removals.html)

This page shows gibberish.
Comment 1 Wim Jongman CLA 2021-02-03 07:26:57 EST 
Moving to UI because nobody follows Doc.
Comment 2 Thomas Wolf CLA 2021-02-03 07:38:33 EST 
Perhaps go via help.eclipse.org? [1] ("Platform Plug-in Developer Guide" -> "Plug-in Migration Guide" -> "Deprecated API Removals").

Doesn't seem to be indexed by Google, though.

[1] https://help.eclipse.org/2020-12/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Fporting%2Fremovals.html&cp%3D2_3_0
Comment 3 Wim Jongman CLA 2021-02-03 08:06:39 EST 
 (In reply to Thomas Wolf from comment #2)
> Perhaps go via help.eclipse.org? [1] ("Platform Plug-in Developer Guide" ->

Right! That is what I was looking for. This must be fixed.

We want to point people there instead of to a raw git page.

However, the current WIP release [1] cannot point to help.eclipse.org because there is no content for 2021-03 [2]

We should generate [2] as part of the normal release cycle and this page [3] Should have a 'Next Release' link...

That way, we can point all our URLs to help.eclipse.org specifically from the new and noteworthy pages. 



[1] https://www.eclipse.org/eclipse/news/4.19/
[2] https://help.eclipse.org/2021-03/index.jsp
[3] https://www.eclipse.org/documentation/
Comment 4 Niraj Modi CLA 2021-02-19 07:58:59 EST 
Removing milestone from 4.19 M3 to 4.19, please re-target accordingly.
Comment 5 Kalyan Prasad Tatavarthi CLA 2021-03-02 02:07:51 EST 
Mass move out of 4.19
Comment 6 Kalyan Prasad Tatavarthi CLA 2021-06-04 00:55:01 EDT 
Mass Move out of 4.20