Git Product home page Git Product logo

developing-oslc-applications's People

Contributors

berezovskyi avatar jadelkhoury avatar jamsden avatar leereamsnyder avatar osaxma avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

developing-oslc-applications's Issues

Eclipse install instructions overlap

Both Lyo and IoTP pages give instructions for Eclipse installation. IoTP page also suggests irrelevant plugins like Mylyn Task List.

Lyo instructions should be updated to accommodate IoTP needs and IoTP should just like to the Lyo instructions for Eclipse.

Links are broken on https://oslc.github.io/developing-oslc-applications/

When I test on my localhost, I have links such as
http://localhost:9000/tutorials.html
http://localhost:9000/why-develop-oslc-applications.html

Once deployed, the links become:
https://oslc.github.io/developing-oslc-applications/tutorials.html
https://oslc.github.io/developing-oslc-applications/why-develop-oslc-applications.html

But that means that relative links between documents are broken.

For example,

The problem is because I am using urls starting with "/", such as "/tutorials."
How can I make it work both on my local machine, and the site?

eclipse_lyo/install-lyo-designer.html suggests to install "Sirius Integration with Xtext"

Do we need it? I think we can remove it from the requirements: https://oslc.github.io/developing-oslc-applications/eclipse_lyo/install-lyo-designer.html

Also, the page suggests to install those plugins even if not installing from the source - but our plugins will pull the necessary dependencies if installed from /{stable,edge}. We should clearly split the page into 4 options:

  1. Installing standalone Lyo Designer (stable).
  2. Installing stable as a plugin.
  3. Installing edge as a plugin.
  4. Running from source (edge or any other branch).

Missing Lyo Validation menu option

Trying to walk through the workshop using the 'OOB' Lyo Designer (not the plugin version) on Windows Server 2012
At this stage: https://oslc.github.io/developing-oslc-applications/eclipse_lyo/toolchain-modelling-workshop#validate-model

  1. Screenshot shows a menu for Toolchain Editor - I dont have that
  2. Text doesnt match sc reenshot anyway - it says to double-click the xml file and then right-click
  3. I did that and I dont have Validate - only Generate Complete Code (see screenshot
    Lyo Designer
    )

Integrate the Bugzilla Workshop into this "OSLC Developer Guide" site

The md source for the Bugzilla worshop (https://archive.open-services.net/resources/tutorials/integrating-products-with-oslc/) is under https://github.com/OSLC/integrating-products-with-oslc-tutorial.

Is it better to migrate this content into this repo?
This also implies we no longer need to refer to https://archive.open-services.net/resources/tutorials/integrating-products-with-oslc/.

  1. At the very least, we update the content to refer to the proper location of the source code.
    https://github.com/eclipse/lyo.docs/tree/master/lyo-rest-workshop

Source option 5 is no longer supported. Use 7 or later

Using the latest Eclipse along with Java 11 - working through the sample applications:

Server Error

Caused by:

javax.servlet.ServletException: org.apache.jasper.JasperException: PWC6033: Error in Javac compilation for JSP

PWC6199: Generated servlet error:
Source option 5 is no longer supported. Use 7 or later.

PWC6199: Generated servlet error:
Target option 5 is no longer supported. Use 7 or later.

Recommend Let's Encrypt for SSL

http://oslc.github.io/developing-oslc-applications/iotp_adaptor/ssl-support.html says that SSL certs are mostly paid and suggests to self-sign certs to get them for free.

Since 2016, Let's Encrypt has become the main provider of the free SSL certs around the world.. It is supported by Cisco, Akamai, Mozilla. The rule of a thumb nowadays is that unless you need EV or other strange things, you should use Let's Encrypt.

So, the advice should be:

Use Let's Encrypt to obtain free certificates unless you need special features such a EV.

Update the website for 4.0.0 release

Shall we update the website for the upcoming release? At least in a pull request.

See the forum post draft for tomorrow: https://hackmd.io/QEK5pMnJQZK3sz9IT0I7Kg. There I specifically write:

@jadelkhoury @jamsden will you please give me a hand with this? Feel free to edit the list below.


TODOs

  • Update oslc4j-client references with oslc-client
  • Mention availability on Maven Central and move SNAPSHOT repos onto a separate page (Participating in Lyo development, for example)
  • Add a 4.0 migration page. See eclipse/lyo#15
  • Include oslc-java-client to oslc-client migration guide
  • Highlight that legacy oslc-java-client is ONLY for use outside a JAX-RS server running Lyo 4.0, i.e. in ETL scripts and other Java SE apps.
  • Introduce RootServicesHelper OSLC/lyo-samples#38 (comment)
  • Introduce IOslcClient OSLC/lyo-samples#38 (comment)

Doc misunderstanding

Hi !
I've just started to work on an OSLC app and we use OAuth request / access tokens.
I was a bit confuse how the flows work so I try to google it and came across your doc here and it says:

A consumer key/secret pair is essentially a login account for an application. If a functional user is associated with the consumer key, consuming apps can use an OAuth Authorization header with the consumer key and secret to access protected resources using One-legged OAuth.

Until here all is fine but later you have a schema (it's much easier to understand so thanks !) that describes how three-legged OAuth works (at least according to the OAuth Bible).
I think it can misleads people and because it's not a easy subject maybe it needs to be improved a bit.

Thanks anyway :)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.