On Jan 12, 2018 11:00 AM, "Mats Wichmann" <[email protected]> wrote:

On 01/11/2018 10:32 AM, LaBrecque, Margaret wrote:

> We are seeking volunteers to help improve the IoTivity website
documentation. If I haven’t made a formal invitation to this list, consider
it done now. We don’t have a plan yet but for sure, we want to clean up the
IoTivity wiki -- so volunteers can let us know if there’s a specific wiki
area they want to tackle.


This will be really great: there's a lot in the wiki that has become
fairly seriously dated.  I improve the ones I have reason to come across
(so I guess I'm a sort of volunteer for this - Margaret knows my
status), but that's very situational, I am not doing this
systematically.  A systematic review of the existing pages to decide
Update / Move / Consolidate / Remove would at least get us to a place
where we know what the hidden surprises are, but also that doesn't
necessarily tell you what is missing, so good to log those as well.

I've created a scratchpad page for people to record places that clearly
need work.  This is also a good place to add stuff that is missing, as
in some of the questions we've seen on the [dev] list recently, like
this one:

==
Do you guys know which version of DTLS is being used on the most recent
version of iotivity? Or maybe where I can find the most recent information?
I'm a little lost with the wiki.
==

Hope this is of some use, if not, just ignore it and use some other
tracking method...  the page is here:

https://wiki.iotivity.org/wiki-update-2018


Looks good to me, but I suggest renaming it to sth like "wikistatus", and
add a link to it at the top of the main wiki page - should be the first
thing visitors see, so they can get an idea of what's outdated and what
isn't. Orphan pages are already a problem on the wiki.

G
_______________________________________________
iotivity-dev mailing list
[email protected]
https://lists.iotivity.org/mailman/listinfo/iotivity-dev

Reply via email to