On Sat, Jul 26, 2014 at 10:54:12PM +0000, w0rp via Digitalmars-d wrote:
> http://w0rp.com:8010/library/index.html
> 
> I just updated the site hosted there with the work I've done on integrating the library documentation to date. I spent a lot of time staring at the pages for a while trying to figure out how to fit everything on a page decent. I admit to hacking the std.algoritm tables into not being tables, etc. I would very much appreciate any pull requests which improve on what I've done so far with it. It's all on GitHub in the usual place.

What do you think about using tables for the functions under each category (e.g. under "searching" in std.algorithm)? Currently it looks like a random scattering of words, and it's quite confusing to look for a particular symbol. A left-justified multi-column layout would be much better IMHO.


> https://github.com/w0rp/new-dlang.org
[...]

I'll keep that in mind for when I have a bit more time; currently I'm rather swamped and probably won't have time to submit PRs.


T

-- 
Computers aren't intelligent; they only think they are.

On Sunday, 27 July 2014 at 00:43:41 UTC, H. S. Teoh via Digitalmars-d wrote:
> On Sat, Jul 26, 2014 at 10:54:12PM +0000, w0rp via Digitalmars-d wrote:
>> http://w0rp.com:8010/library/index.html
>> 
>> I just updated the site hosted there with the work I've done on
>> integrating the library documentation to date. I spent a lot of time
>> staring at the pages for a while trying to figure out how to fit
>> everything on a page decent. I admit to hacking the std.algoritm
>> tables into not being tables, etc. I would very much appreciate any
>> pull requests which improve on what I've done so far with it. It's all
>> on GitHub in the usual place.
>
> What do you think about using tables for the functions under each
> category (e.g. under "searching" in std.algorithm)? Currently it looks
> like a random scattering of words, and it's quite confusing to look for
> a particular symbol. A left-justified multi-column layout would be much
> better IMHO.

The std.algortihm documentation doesn't look good, and I don't have any good ideas for it.

On 7/26/14, 6:30 PM, w0rp wrote:
> The std.algortihm documentation doesn't look good, and I don't have any
> good ideas for it.

I find std.algorithm among the best documented libraries out there! I must be in denial... -- Andrei

On Mon, Jul 28, 2014 at 09:58:59AM -0700, Andrei Alexandrescu via Digitalmars-d wrote:
> On 7/28/14, 12:29 AM, Gary Willoughby wrote:
> >I am contributing but you are completely ignoring me and attacking what i'm saying. I've been a professional web application developer for years and have a lot of experience with design and UX. Everybody here is completely ignoring that fact! You don't even understand branding. So what's the point of me trying to contribute?

Your hostile tone may have contributed to that reaction, however justified your arguments may have been. Coming into a volunteer project and telling people things like "this is garbage", "this is amateurish", "you should stop", "you don't understand anything at all", is very hostile, and therefore likely to provoke a negative reaction, even if the work concerned actually *is* garbage, amateurish, etc..

As Andrei said (quoted below), if instead of tearing others' (voluntary!) work into pieces, you produce a superior piece of work and show it (even if it's just a concept sketch of the end result, not the actual implementation), it will be much more convincing, and people will be much more likely to listen to you. As they say, "show, don't tell".


> I've been in similar situations in the past so I sympathize. The one thing I noticed gets the point across is to just do good work and just show it.  People otherwise ignorant of what goes into a piece of work _can_ often appreciate a compelling end result.
[...]


T

-- 
Many open minds should be closed for repairs. -- K5 user

On 07/27/2014 04:39 AM, Andrei Alexandrescu wrote:
> On 7/26/14, 6:30 PM, w0rp wrote:
>> The std.algortihm documentation doesn't look good, and I don't have any
>> good ideas for it.
>
> I find std.algorithm among the best documented libraries out there! I
         ^~~~~~~~~~~~~~~~~~~

This actually tripped me up while speed-reading. :o) Intended?

> must be in denial... -- Andrei
>