diff --git a/docs/developers/index.html b/docs/developers/index.html index ef57401..1b76f2a 100644 --- a/docs/developers/index.html +++ b/docs/developers/index.html @@ -3,6 +3,17 @@ title: Developers group: "navigation" --- +
+

Guide for WoT Developers

+ + +

+ If you are new to the Web of Things, there are different ways to be knowledgeable and start using Web of Things + in your applications. + In our developer journey document, you can find one such way. +

+ +

Developer Tools

diff --git a/docs/developers/journey.html b/docs/developers/journey.html new file mode 100644 index 0000000..879f2dc --- /dev/null +++ b/docs/developers/journey.html @@ -0,0 +1,111 @@ +--- +layout: default +title: Developer Journey +group: "navigation" +--- +
+

Guide for WoT Developers

+ +

+ There are many ways to be an expert in the Web of Things and below is our proposal on how to get there. + This assumes no prior knowledge on any of the technologies the Web of Things builds upon. + Since Web of Things bridges many fields such as Web development, embedded system development and Internet protocols, + the preliminary sections below are tagged with the corresponding field and can be unfolded depending on your prior knowledge. +

+ +
    +
  1. JSON: + +
      +
    1. Learning Sources
      2. +
    2. Configuration files
      3. +
    3. Exchanging data between devices (APIs)
      4. +
    4. Metadata (e.g. API Descriptions)
      5. +
    +
    2. + +
  2. JSON Schema: + +
      +
    1. Learning Sources
      2. +
    2. Validation of JSON instances
      3. +
    3. Generation of documentation, types for programming languages, UIs
      4. +
    +
    3. + +
  3. Node.js (optional) + +
      +
    1. Explaining why (reference implementation)
      2. +
    2. Node.js Tutorials
      3. +
    +
    4. + +
  4. JSON-LD: + +
      +
    1. Learning Sources
      2. +
    2. Bringing context to data, specifying the meaning (semantics) of the data
      3. +
    +
    5. + +
  5. A protocol, HTTP/REST is recommended: + +
      +
    1. Learning Sources for the HTTP protocol
      2. +
    2. How one programs a server (Thing)
      3. +
    3. How one uses a REST Client and how one programs one
      4. +
    +
    6. + +
  6. Working with (constrained) Physical Things + +
      +
    1. Understanding Device Categories
      2. +
    2. Understanding lower level protocols (wireless and wired)
      3. +
    3. Understanding how to work with sensors/li> +
    4. Understanding how to work with actuators
      5. +
    5. Example Thing development with Raspberry Pi
      6. +
    6. Example Thing development with ESP32
      7. +
    +
    7. + +
  7. TD: +
      +
    1. Reading the spec
      2. +
    2. Use a TD for a UI
      3. +
    3. Interact with a Thing
      4. +
    4. Existing Tooling
      5. +
    +
    8. + +
  8. Discovery: +
      +
    1. Introduction mechanisms
      2. +
    2. Register TDs
      3. +
    3. Find/Fetch TDs
      4. +
    4. Existing implementations
      5. +
    +
    9. + +
  9. Scripting API: +
      +
    1. Idea behind how to program interactions with devices, the WoT way!
      2. +
    2. Reading the specification
      3. +
    3. node-wot
      4. +
    +
    10. + +
  10. Binding Templates: +
      +
    1. See how your knowledge in one protocol can apply to others
      2. +
    2. See how other protocols work in WoT
      3. +
    +
    11. + +
  11. Profiles: +
      +
    1. Reduce implementation effort for your Consumers by implementing a profile
      2. +
    12. +
+