Hi Thiago,

I would **like** to see the website redesigned so that community can grow and 
change as it needs by singularly using the Wiki. Once a major release (ie. 
"1.0.0") is made, it may behoove us to document these things on the main page. 
However, until then, any work up to that point should likely only exist on the 
Wiki.

With this website locked down and not necessarily matching what the wiki has 
up, this makes the IoTivity project look seriously disorganized. This may also 
create issues for end users who put time into practicing the wrong 
documentation. It's a real scenario where an end user may simply walk away from 
IoTivity due to frustration. All contribution work (including all steps up to 
actually contributing) can change & will change. This model where any developer 
who make a slight change must contact one of a handful of people to broadcast 
their changes is not scalable, and isn't even working currently.

Please re-consider the avoidance of re-designing. Perhaps we can add a new 
column "Wiki" and we can provide some quick links that people whom are 
absolutely brand new should look at first. Also, as said above, any concrete 
documentation for a major release could certainly exist on the main page of 
Iotivity.

Thanks,

Joey
-----Original Message-----
From: iotivity-dev-bounces at lists.iotivity.org 
[mailto:iotivity-dev-boun...@lists.iotivity.org] On Behalf Of Thiago Macieira
Sent: Thursday, June 25, 2015 4:18 PM
To: iotivity-dev at lists.iotivity.org
Subject: Re: [dev] IoTivity 'Getting-Started' Guides

On Thursday 25 June 2015 16:25:32 Morrow, Joseph L wrote:
> All,
> 
> Can someone please remove the "Getting Started" and "Programmers Guide"
> guides from the main pages of iotivity.org? These documents should be 
> moved to the wiki at wiki.iotivity.org. At this time, only a handful 
> of people can make changes to the main pages of iotivity.org.
> 
> Please note that the "Getting Started" and "Programmers Guide" guides 
> on iotivity.org are seriously out of date and leave end users real confused.
> Once these guides are properly transferred to the wiki, any 
> contributors may update them as needed.

Hi Joey

I can't remove two of three main columns of the iotivity.org homepage. That 
would seriously compromise the design of the website.

Instead, let's update the content linked from
        https://www.iotivity.org/documentation
        https://www.iotivity.org/get-involved

Just let me know what you'd like to see showing up there and I'll make it 
happen.

PS: I'm already taking care of the API docs link, only waiting for LF tech 
support

> 
> I am currently working on a newer "Getting Started" guide for Arduino now.
> Someone else should consider working on revamping the "Getting Started"
> guides for Linux, Tizen, Android, and OSX.
> 
> Thank You,
> 
> Joseph Morrow

--
Thiago Macieira - thiago.macieira (AT) intel.com
  Software Architect - Intel Open Source Technology Center

_______________________________________________
iotivity-dev mailing list
iotivity-dev at lists.iotivity.org
https://lists.iotivity.org/mailman/listinfo/iotivity-dev

Reply via email to