General information about the Web of Things can be found on https://www.w3.org/WoT/.
This is a repository for the W3C Web of Things Interest Group.
This repository is mainly for archival and general logistics. For work on a specific topic, one of the other repositories dedicated to that topic may be more relevant:
- WoT Marketing General introductory material, including tutorials and getting started guides.
- WoT Architecture Overall architecture, responsible for WoT Architecture deliverable.
- WoT Profile Interoperability Profiles. Responsible for the WoT Profile WoT Profile deliverable.
- WoT Thing Description Thing Description metadata, responsible for WoT Thing Description deliverable.
- WoT Security
- WoT Discovery
- WoT Scripting API
- WoT Use Cases Use case collection (WIP, still in bring-up).
- WoT Testing
- Fork the
w3c/wotrepository into your own account (botton in the top right corner) - Navigate to a file in your master branch that you want to change (e.g., http://github.com/{your-account}/wot/blob/master/charters/wot-ig-2016.html or http://github.com/{your-account}/wot/blob/master/charters/wot-wg-2016.html)
- Click the edit icon in the upper right (pen next to Raw/Blame/History)
- Make your edits (e.g., directly in the online editor or by copying the text to your favorite editor and back)
- Give a meaningful commit message (i.e., do not leave "Update ...")
- Choose Create a new branch for this commit and start a pull request and give a proper name (e.g.,
charters-ig-scope-plugfest) - Click Propose file change
- Skip the form, since you do not want to create a PR to your fork. Instead, go to https://github.com/w3c/wot, where GitHub will have found your new branch and will offer to open a pull-request (base fork:
w3c/wot, base:master... head fork:{your-account}/wot, compare:{your-branch}). - If you have a separate change proposal for the same file, go back to your master branch and repeat the process from clicking the edit icon.
- If the pull-request discussion expects you to update your change proposal, go to your branch corresponding to the PR, click the edit icon, and commit directly to that branch.
- Fork the
w3c/wotrepository into your own account - Create a branch in your fork for one particular topic (e.g., a single IG scope item) with a proper name (e.g.,
charter-ig-scope-plugfest) - Make your edits and commit
- Push the new branch to your own repository fork
- GitHub will automatically offer to open a pull-request to
w3c/wot(from your new branch to master)
- https://help.github.com/articles/using-pull-requests/ provides a tutorial on GitHub pull-requests.
- If you have not worked with GitHub in this way before, we will give direct assistance.