Re: First feedback(s)

On 9 Oct 2012, at 05:16, Amirouche Boubekki <amirouche.boubekki@gmail.com> wrote:

> Héllo,
> 
> 
> First, I'd like to thanks everyone involved in the project, I think it's an awesome idea and it has a lot of potential.

Hi Amirouche, thank you so much for your feedback - I will start looking through this and turning it into bugs and responses! See below for some immediate responses. In future, if you have points to make about improving the site, feel free to just submit them as bugs, at https://www.w3.org/Bugs/Public/describecomponents.cgi?product=webplatform.org

> 
> My first questions were answered by the wiki and IRC, but IRC was a bit crowded, I though it might be better to raise issues on the ML, so here I am. 

Probably a good idea ;-)

> 
> For people new to the project (like most of us ^^) which might have the same questions as me, here are the pages that I found useful with some comments:
> 
> - Is this website open-source? It's nice to know which programs are used to build the platform, a full code disclosure might have been better. Plus the development of more applications will be made easier which would be properly labeled as WPD and will help avoid applications scams.

I have added an answer to the FAQ about this, with some seed data. Since I didn't have much part in building the site, I will defer to someone else to fill this in with more detail.

http://docs.webplatform.org/wiki/WPD:FAQ

> - Getting Started It's a nice page, the diagram is nice and interesting 
>   a) «You can make meaningful contributions whether you have five minutes, half an hour, or half a day.» is not mentioned in the diagram
>   b) Some pages in the diagram do no exists or I did not find them except Style Guide which is actually Manual Of Style
>   c) the Pages from the diagram are not clickable, it might be nice to do a recap below it
>   d) Is Tasks to be merged with the «five minutes, half an hour, or half a day» contribution paragraphs ?
> - FAQ

I've raised a bug about this - your suggestions are cool.

> 
> Other interesting links which might be wiki page inspirational sources most viewed, most answered, highest voted questions in the forum.

Another set of good ideas! I will raise a bug.

> 
> About the topic structure, what worked well in Django and Python community is the following:
> - Getting started

Ok, so we've pretty much got this - this is why I created the beginner's article listing, at http://docs.webplatform.org/wiki/beginners

> - Topical howtos of different level properly flagged as is

Ah, so different levels of article - beginner, intermediate, advanced, that kind of thing? This doesn't really apply to the references, but it could certainly be useful for the tutorials

> - References API

We are planning to do this already!

> 
> It's seems be what is done but it isn't mentioned in Architecture.
> 
> The topic of backend languages has been mentioned on IRC, I find it great a idea, if it's possible to have cross language references or topic pages like MVC with explanations of the differences between the different implementations across languages. 

See the FAQ entry about server-side

http://docs.webplatform.org/wiki/WPD:FAQ#Will_this_site_include_information_on_server-side_languages.2C_like_PHP.2C_Perl.2C_Ruby.2C_Python.2C_etc..3F

> 
> There is a lot of tables in the wiki, there are not easy to read, I would rather see something like CategoryTree.

Yeah - these are not great representations of that data. We have the articles put in these structures as placeholders until we build a better way to automate the printout of all the reference/tutorial articles.

> 
> The search box on top of the page hits the wiki database, but it looks like it a global search.

Not sure what you mean here? The search could probably do with some improvements...

> 
> What about database(s) dumps ?

no 100% sure what you mea here.

> 
> What W3C documents will become ? Should WPD replace them or should we have reference them ?

webplatform will never replace the specs, if that is what you are saying. The two will have markedly different audiences.

> 
> I would like to contribute to the french translation.

Cool! Please see my earlier message about translations - http://lists.w3.org/Archives/Public/public-webplatform/2012Oct/0021.html

Received on Thursday, 11 October 2012 08:22:49 UTC