528173 – SWT Website Documentation needs a refresh

Bug 528173 - SWT Website Documentation needs a refresh

Summary: SWT Website Documentation needs a refresh

Status:	RESOLVED FIXED

Alias:	None

Product:	Platform
Classification:	Eclipse Project
Component:	SWT (show other bugs)
Version:	4.8
Hardware:	PC All

Importance:	P5 normal (vote)
Target Milestone:	---
Assignee:	Platform-SWT-Inbox
QA Contact:

URL:
Whiteboard:
Keywords:	Documentation

Depends on:	528435
Blocks:
	Show dependency tree

Reported:	2017-12-05 13:20 EST by Leo Ufimtsev
Modified:	2020-11-09 06:00 EST (History)
CC List:	6 users (show)

See Also:	476913 Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Git Commit Gerrit Change Gerrit Change Git Commit Git Commit

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 Leo Ufimtsev

2017-12-05 13:20:45 EST

The SWT documentation would benefit from a refresh.

- It has screenshots from Windows XP and very old versions of Mac/Linux
- It's not clear how to contribute patches on Win/Cocoa/Linux. (People complain about this.
- It's scattered:
https://www.eclipse.org/swt/
https://wiki.eclipse.org/SWT/Devel/
- There's too much and not enough of it. We should have a 'quick start' and blog-entries of sort for very specific entries.
-  It's also for the most part out of date, much of it is no longer relevant.

This makes it difficult for people who are interested to actually contribute to the project.

I plan to do an overhaul upon completion of webkit2 port.

Please add your concerns/suggestions to this bug.

Btw, does anyone know of a good way to preview the html or setup for website update? Most of the files are php files and have some other dependencies not found in www/swt project.

Comment 1 Leo Ufimtsev

2017-12-12 09:44:46 EST

@ CC'ed folks, if you have anything in particular that you'd like to see, please let me know.

Comment 2 Matthias Fuchs

2017-12-12 14:52:46 EST

In general, I‘d love to have a kickstart tutorial on how to
* build swt and the platform libs from source
* implement a new native widget

Comment 3 Leo Ufimtsev

2017-12-13 10:31:58 EST

(In reply to Matthias Fuchs from comment #2)
> In general, I‘d love to have a kickstart tutorial on how to
> * build swt and the platform libs from source
> * implement a new native widget

Thank you for request.
Do you mean native-native as in native on Windows,Cocoa and GTK (e.g Button) or native as in a custom-drawn widget designed once and works on all platforms (like for example the nebular widgets).

Comment 4 Matthias Fuchs

2017-12-13 11:44:01 EST

Native as in OS-native, like cocoa etc.

Comment 5 Leo Ufimtsev

2017-12-13 11:46:01 EST

(In reply to Matthias Fuchs from comment #4)
> Native as in OS-native, like cocoa etc.

ok, thanks for clarification.

Comment 6 Leo Ufimtsev

2018-06-29 16:11:58 EDT

Handing over into trusted hands.

Comment 7 Eric Williams

2019-06-06 10:24:32 EDT

Re-assigning to the pool as I do not have time to work on this at the moment.

Comment 8 Niraj Modi

2020-01-06 03:12:49 EST

(In reply to Leo Ufimtsev from comment #0)
> The SWT documentation would benefit from a refresh.
> 
> - It has screenshots from Windows XP and very old versions of Mac/Linux
It's a screen grab of Snippet266.java
I shall update the image for Windows10 shortly.

Comment 9 Eclipse Genie

2020-01-06 05:10:25 EST

New Gerrit change created: https://git.eclipse.org/r/155272

Comment 10 Eclipse Genie

2020-01-06 05:11:09 EST

Gerrit change https://git.eclipse.org/r/155272 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=c5ae3dc0a8c50576b49ddb82bebb84fba94a0c09

Comment 11 Eclipse Genie

2020-01-08 07:09:22 EST

New Gerrit change created: https://git.eclipse.org/r/155474

Comment 12 Eclipse Genie

2020-01-08 07:14:38 EST

Gerrit change https://git.eclipse.org/r/155474 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=50ab8c2f4af54bf5bf5a89c5189252220e247cbf

Comment 13 Eclipse Genie

2020-01-10 06:01:45 EST

New Gerrit change created: https://git.eclipse.org/r/155603

Comment 14 Eclipse Genie

2020-01-10 06:02:29 EST

Gerrit change https://git.eclipse.org/r/155603 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=7fd26444b05e73a9354a28118f34c6fe8fa015c1

Comment 15 Eclipse Genie

2020-01-17 05:33:38 EST

New Gerrit change created: https://git.eclipse.org/r/156064

Comment 16 Eclipse Genie

2020-01-17 05:36:13 EST

Gerrit change https://git.eclipse.org/r/156064 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=e306236834d096446f91784521189e0ef0f52f6c

Comment 17 Eclipse Genie

2020-01-17 11:47:13 EST

New Gerrit change created: https://git.eclipse.org/r/156104

Comment 18 Eclipse Genie

2020-01-17 11:48:33 EST

Gerrit change https://git.eclipse.org/r/156104 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=5efce5c2ab20e7322abe2e05ead10fb95b1caa25

Comment 19 Eclipse Genie

2020-01-24 03:29:06 EST

New Gerrit change created: https://git.eclipse.org/r/156495

Comment 20 Eclipse Genie

2020-01-24 03:29:26 EST

Gerrit change https://git.eclipse.org/r/156495 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=c69a7d1f8266b9d111ea86a6617efa306b3027a2

Comment 21 Eclipse Genie

2020-01-27 01:34:59 EST

New Gerrit change created: https://git.eclipse.org/r/156599

Comment 22 Eclipse Genie

2020-01-27 01:35:43 EST

Gerrit change https://git.eclipse.org/r/156599 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=3495f476a532ba9a794f48973d1aec75d9677e5e

Comment 23 Eclipse Genie

2020-02-07 06:56:42 EST

New Gerrit change created: https://git.eclipse.org/r/157349

Comment 24 Eclipse Genie

2020-02-07 06:57:27 EST

Gerrit change https://git.eclipse.org/r/157349 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=d24b999fa2d7ea2a66325d83a8d74721336596ef

Comment 25 Eclipse Genie

2020-02-07 07:25:08 EST

New Gerrit change created: https://git.eclipse.org/r/157353

Comment 26 Eclipse Genie

2020-02-07 07:31:23 EST

Gerrit change https://git.eclipse.org/r/157353 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=b45852684def6aab979a8e47f0b0746c672a5752

Comment 27 Eclipse Genie

2020-02-10 03:21:29 EST

New Gerrit change created: https://git.eclipse.org/r/157417

Comment 28 Eclipse Genie

2020-02-10 04:20:02 EST

Gerrit change https://git.eclipse.org/r/157417 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=50b513a4ecbc720b7be4476ec5aca774922c4314

Comment 29 Eclipse Genie

2020-06-08 09:47:58 EDT

New Gerrit change created: https://git.eclipse.org/r/164445

Comment 30 Eclipse Genie

2020-06-08 09:48:02 EDT

New Gerrit change created: https://git.eclipse.org/r/164446

Comment 31 Eclipse Genie

2020-06-08 09:48:17 EDT

Gerrit change https://git.eclipse.org/r/164445 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=5b5a2001e95646856f8152c7961fa108aef2d98c

Comment 32 Eclipse Genie

2020-06-08 09:49:01 EDT

Gerrit change https://git.eclipse.org/r/164446 was merged to [master].
Commit: http://git.eclipse.org/c/www.eclipse.org/swt.git/commit/?id=db2f97d0059ccbfa9af3502e13a25c156266ead5

Comment 33 Alexander Kurtakov

2020-11-09 06:00:20 EST

Let's mark this one as fixed. It's too generic and gathered too much content already.