Uploaded image for project: 'OASIS OSLC Lifecycle Integration Core (OSLC Core) TC'
  1. OASIS OSLC Lifecycle Integration Core (OSLC Core) TC
  2. OSLCCORE-38

Create a Quickstart guide for OSLC

    XMLWordPrintable

    Details

    • Type: Task
    • Status: Resolved
    • Priority: Major
    • Resolution: Fixed
    • Component/s: None
    • Labels:
      None
    • Proposal:
      Hide

      Such guidelines are likely better provided by tool vendors or through open source projects that ground the guides in client and/or server implementations. This is probably not appropriate for normative specifications, and there are enough existing OSLC implementations, and the Eclipse Lyo Tutorial that can provide reasonable starting points. Since OSLC3 is compatible with OSLC2, this should be sufficient.

      Show
      Such guidelines are likely better provided by tool vendors or through open source projects that ground the guides in client and/or server implementations. This is probably not appropriate for normative specifications, and there are enough existing OSLC implementations, and the Eclipse Lyo Tutorial that can provide reasonable starting points. Since OSLC3 is compatible with OSLC2, this should be sufficient.
    • Resolution:
      Hide

      Closing as out of scope for the TC.

      Show
      Closing as out of scope for the TC.

      Description

      The information in the OSLC specifications is necessarily robust enough to build an entire OSLC implementation. However, many people adopting OSLC will only implement "just enough" OSLC to address their needs, or they may only be consuming a limited amount of data from an OSLC provider. Review the detailed specifications and understanding the underlying technology and semantics (RDF, LDP, etc) is a lot to ask from these types of OSLC users.

      It would be helpful, and encourage wider adoption, to provide some form of quickstart guide that helps potential OSLC consumers get just enough information to help them with simple or common integration scenarios. Such a document would also be useful for anyone just starting with OSLC to guide them on where to go for a deeper understanding of OSLC. This guide should be no longer than 3 pages, and the shorter the better.

      For example, such a guide could provide:

      • Specific examples of common ways to query information in OSLC servers.
      • A list of things OSLC should be used for, and a list of things OSLC can't be used for.
      • The location of OSLC documents and the relationship between OASIS and open-services.net.
      • An introduction to Lyo.
      • etc.

        Attachments

          Activity

            People

            • Assignee:
              jamsden James Amsden
              Reporter:
              jruehlin Jim Ruehlin
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: