search

osate / osate2

Open Source AADL2 Tool Environment
http://osate.org
Eclipse Public License 2.0
37 stars 8 forks source link

Stale documentation #2850

Closed podhrmic closed 1 year ago

podhrmic commented 1 year ago

Summary Some documentation at https://osate.org/setup-development.html is stale. Specifically:

the installer crashes on Ubuntu 20.04, downloading Eclipse for Java and then importing OSATE projects works, perhaps it should be documented?

Select Eclipse IDE for Java Developers as the base product to install, and select 2022-06 as the product version. DO NOT USE Latest Release (2022-06).

This is a contradiction - 2022-06 seems to work OK.

Version 17 is no longer available for download and compiling Java FX from scratch is rather tedious. Liberica SDK offers the Java FX 17, so the docs should perhaps be updated.

lwrage commented 1 year ago

Documentation has been clarified regarding the eclipse version. (Latest Release(2022-06) entry was replaced with Latest Release( 2022-09) in September with the Eclipse 2022-09 release.) Clarified JavaFX download instructions. Added a note that available variables change based on the selections in drop-downs.

Please provide more information about the installer crash. I recently ran it on Ubuntu 20.04 without a problem.

podhrmic commented 1 year ago

Thanks for the updates. One more nitpick - the getting help section recommends using google groups for reporting issue, while the development section mentions using github issues. Is the intend to keep the osate user questions on the mailing list, and osate developer/development related issues on github?

Please provide more information about the installer crash. I recently ran it on Ubuntu 20.04 without a problem.

Looks like a good old reset fixed it, not sure what was wrong the first time.

lwrage commented 1 year ago

I've updated the text to point to the Google group. In general we want to direct questions to the group and limit github issues to bugs and feature requests.