Re: new documentation format for std.algorithm

On 2/2/11, Andrei Alexandrescu wrote: > Following ideas and advice from this newsgroup, I have a draft at > > http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html > Andrei > You know, we could use the same thing for the language reference. E.g.: http://www.digitalmars.com/d/2

Re: new documentation format for std.algorithm

""Jérôme M. Berger"" wrote in message news:iiht66$vnt$1...@digitalmars.com... > > Plus, very often there are two categories of "designers" working on > these sites. The first do not know anything about the web and create > a mockup of the site using Photoshop, then the others (who do know > at le

Re: new documentation format for std.algorithm

Jeff Nowakowski wrote: > On 02/04/2011 11:38 AM, David Nadlinger wrote: >> maybe you'll also discover that the designers of the most frequented >> sites aren't exactly complete dorks either. > > I've seen tons of designs by high-profile sites, and many are > pointlessly broken for me. I've seen th

Re: new documentation format for std.algorithm

On 02/04/2011 11:38 AM, David Nadlinger wrote: I tried to explain the issue to you, but you have been quick to dismiss any attempt to do so based on your own opinion. You've made silly arguments about opinion yourself, stating that a million Wikipedia users would complain if the default font s

Re: new documentation format for std.algorithm

On 2/4/11 4:39 PM, Jeff Nowakowski wrote: It does, as I explained in my other post to you. Repeating an assertion is not a logical argument. I tried to explain the issue to you, but you have been quick to dismiss any attempt to do so based on your own opinion. I won't spend any more time on t

Re: new documentation format for std.algorithm

On 02/03/2011 06:15 PM, David Nadlinger wrote: This is exactly the issue I was talking about, using relative font sizes in their current incarnation doesn't solve any problems per se. It does, as I explained in my other post to you. Repeating an assertion is not a logical argument. Also, it'

Re: new documentation format for std.algorithm

On 2/3/11 6:42 PM, "Jérôme M. Berger" wrote: That is because Wikipedia text *is* to small! Wikipedia has the font size set to 80% of the default, which means that they *want* their text to be too small. That is not a reason why we should emulate them. This is exactly the issue I was tal

Re: new documentation format for std.algorithm

On Thursday, February 03, 2011 11:22:14 Andrei Alexandrescu wrote: > On 2/3/11 11:02 AM, Jeff Nowakowski wrote: > > On 02/03/2011 11:09 AM, Andrei Alexandrescu wrote: > >> Apparently at least for one person choosing the default makes the text > >> too large. Making the default smaller in turn makes

Re: new documentation format for std.algorithm

On 2/3/11 11:02 AM, Jeff Nowakowski wrote: On 02/03/2011 11:09 AM, Andrei Alexandrescu wrote: Apparently at least for one person choosing the default makes the text too large. Making the default smaller in turn makes Wikipedia text too small. I wouldn't want to require a change of defaults to

Re: new documentation format for std.algorithm

On 02/03/2011 04:11 PM, Jeff Nowakowski wrote: On 02/03/2011 01:21 AM, Andrei Alexandrescu wrote: Someone mentioned in this thread that leaving all font sizes to default causes the text to be too small. The rhetoric is convincing but I'm afraid it can't be properly translated into reality. I

Re: new documentation format for std.algorithm

On 02/03/2011 05:05 PM, Andrei Alexandrescu wrote: There's a step between fixed font sizes and no information about font sizes at all: relative sizes (-1, -2, etc). Bye, bearophile That is used but I don't think it helps choosing something that works well for everyone. This cannot be done. J

Re: new documentation format for std.algorithm

Andrei Alexandrescu wrote: > On 2/3/11 9:11 AM, Jeff Nowakowski wrote: >> On 02/03/2011 01:21 AM, Andrei Alexandrescu wrote: >>> >>> Someone mentioned in this thread that leaving all font sizes to default >>> causes the text to be too small. >>> >>> The rhetoric is convincing but I'm afraid it can'

Re: new documentation format for std.algorithm

On 02/03/2011 11:54 AM, David Nadlinger wrote: Sorry, I don't quite get your point there. Of course there is the standard 960px desktop viewport to target, and typical mobile device dimensions are getting more and more important as well. It's part of delivering a good job to make sure that your

Re: new documentation format for std.algorithm

On 02/03/2011 11:09 AM, Andrei Alexandrescu wrote: Apparently at least for one person choosing the default makes the text too large. Making the default smaller in turn makes Wikipedia text too small. I wouldn't want to require a change of defaults to see our website or to compete with Wikipedia

Re: new documentation format for std.algorithm

On 2/3/11 4:06 PM, Jeff Nowakowski wrote: What the designers do is pick something that looks good for them, and if they're /really/ "professional", they'll assume some "standard" screen real-estate is available and design the page as if the user was browsing at that. More likely they'll just try

Re: new documentation format for std.algorithm

On 2/3/11 9:11 AM, Jeff Nowakowski wrote: On 02/03/2011 01:21 AM, Andrei Alexandrescu wrote: Someone mentioned in this thread that leaving all font sizes to default causes the text to be too small. The rhetoric is convincing but I'm afraid it can't be properly translated into reality. It doe

Re: new documentation format for std.algorithm

On 2/3/11 4:24 AM, bearophile wrote: Andrei: Someone mentioned in this thread that leaving all font sizes to default causes the text to be too small. The rhetoric is convincing but I'm afraid it can't be properly translated into reality. There's a step between fixed font sizes and no informa

Re: new documentation format for std.algorithm

On 02/03/2011 01:21 AM, Andrei Alexandrescu wrote: Someone mentioned in this thread that leaving all font sizes to default causes the text to be too small. The rhetoric is convincing but I'm afraid it can't be properly translated into reality. It doesn't matter *what* you choose, somebody wil

Re: new documentation format for std.algorithm

On 02/03/2011 12:26 AM, David Nadlinger wrote: Yet I'd guess that 99% of all people on the web have never touched their browsers default font size/style controls… Then let them get the defaults. Do you think designers know better? They can't, because every screen and browser window comes in a

Re: new documentation format for std.algorithm

On 2011-02-03 07:21, Andrei Alexandrescu wrote: On 2/2/11 11:06 PM, Jeff Nowakowski wrote: On 02/02/2011 10:59 AM, Andrei Alexandrescu wrote: (Absolute) font size does not belong to the page designer, instead to the user. Just press dedicated key binding (often ctrl-), or whatever command to s

Re: new documentation format for std.algorithm

On Wed, 02 Feb 2011 03:45:59 -0500, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief desc

Re: new documentation format for std.algorithm

On 02/03/2011 06:19 AM, Walter Bright wrote: Jérôme M. Berger wrote: Andrei Alexandrescu wrote: I'm not sure about that. Facebook's site is professionally designed and I think they use fixed font sizes all over the place. "Professionally designed" does not mean that they did the job right!

Re: new documentation format for std.algorithm

Andrei: > Someone mentioned in this thread that leaving all font sizes to default > causes the text to be too small. > > The rhetoric is convincing but I'm afraid it can't be properly > translated into reality. There's a step between fixed font sizes and no information about font sizes at all

Re: new documentation format for std.algorithm

On 2/2/11 11:06 PM, Jeff Nowakowski wrote: On 02/02/2011 10:59 AM, Andrei Alexandrescu wrote: (Absolute) font size does not belong to the page designer, instead to the user. Just press dedicated key binding (often ctrl-), or whatever command to set it appropriately. I'm not sure about that. F

Re: new documentation format for std.algorithm

On 2/3/11 6:06 AM, Jeff Nowakowski wrote: The whole idea is just wrong. People browse the web in all kinds of default font sizes, […] Yet I'd guess that 99% of all people on the web have never touched their browsers default font size/style controls… David

Re: new documentation format for std.algorithm

Jérôme M. Berger wrote: Andrei Alexandrescu wrote: I'm not sure about that. Facebook's site is professionally designed and I think they use fixed font sizes all over the place. "Professionally designed" does not mean that they did the job right! Apple's SDK documentation on their web

Re: new documentation format for std.algorithm

On 02/02/2011 10:59 AM, Andrei Alexandrescu wrote: (Absolute) font size does not belong to the page designer, instead to the user. Just press dedicated key binding (often ctrl-), or whatever command to set it appropriately. I'm not sure about that. Facebook's site is professionally designed an

Re: new documentation format for std.algorithm

spir wrote: > Is there an easy way to avoid duplicates in cheat sheet (2 readln, 3 writeln)? Yes, easily, done now. http://arsdnet.net/d-web-site/std_stdio.html > * The pointer to readln points ~ 3 lines below readln's doc's headline. Fixed via hackish. The real cause here is ddoc for some reaso

Re: new documentation format for std.algorithm

On Wednesday, February 02, 2011 18:27:34 spir wrote: > On 02/03/2011 02:24 AM, Jonathan M Davis wrote: > > The hyphenating looks horrible and is hard to > > read. I see no reason to make the category column worry about space so > > much. I would expect the functions column to be able to handle the

Re: new documentation format for std.algorithm

On 02/03/2011 03:20 AM, Adam Ruppe wrote: I downloaded your new style to my site too and ran the automatic table generator over std.stdio so we can see how it looks with some different content. http://arsdnet.net/d-web-site/std_stdio.html I actually like that quite a bit! I don't have the hyphe

Re: new documentation format for std.algorithm

On 02/03/2011 02:24 AM, Jonathan M Davis wrote: The hyphenating looks horrible and is hard to read. I see no reason to make the category column worry about space so much. I would expect the functions column to be able to handle the width adjustment for various screen sizes. Screenshot:http://is.

Re: new documentation format for std.algorithm

Andrei wrote: > I made one more pass and made the following changes: I downloaded your new style to my site too and ran the automatic table generator over std.stdio so we can see how it looks with some different content. http://arsdnet.net/d-web-site/std_stdio.html I actually like that quite a b

Re: new documentation format for std.algorithm

On Wednesday, February 02, 2011 17:37:27 Andrei Alexandrescu wrote: > On 2/2/11 7:24 PM, Jonathan M Davis wrote: > > On Wednesday, February 02, 2011 11:12:07 Andrei Alexandrescu wrote: > >> On 2/2/11 2:45 AM, Andrei Alexandrescu wrote: > >>> Following ideas and advice from this newsgroup, I have a

Re: new documentation format for std.algorithm

On 2/2/11 7:24 PM, Jonathan M Davis wrote: On Wednesday, February 02, 2011 11:12:07 Andrei Alexandrescu wrote: On 2/2/11 2:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.htm

Re: new documentation format for std.algorithm

On Wednesday, February 02, 2011 11:12:07 Andrei Alexandrescu wrote: > On 2/2/11 2:45 AM, Andrei Alexandrescu wrote: > > Following ideas and advice from this newsgroup, I have a draft at > > > > http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html > > > > There are two tables,

Re: new documentation format for std.algorithm

On 2/2/11 5:20 PM, David Nadlinger wrote: On 2/2/11 11:34 PM, David Nadlinger wrote: Setting font size, line height and element dimensions in pixels is the only option if you want an at least somewhat consistent user experience […] Okay, I guess that should rather be »the most reasonable optio

Re: new documentation format for std.algorithm

On 2/2/11 11:34 PM, David Nadlinger wrote: Setting font size, line height and element dimensions in pixels is the only option if you want an at least somewhat consistent user experience […] Okay, I guess that should rather be »the most reasonable option if you want an at least somewhat consist

Re: new documentation format for std.algorithm

On 2/2/11 10:03 PM, spir wrote: On 02/02/2011 09:40 PM, "Jérôme M. Berger" wrote: Andrei Alexandrescu wrote: I'm not sure about that. Facebook's site is professionally designed and I think they use fixed font sizes all over the place. "Professionally designed" does not mean that they did the

Re: new documentation format for std.algorithm

"Andrei Alexandrescu" wrote in message news:iibvgn$13bt$1...@digitalmars.com... > On 2/2/11 9:08 AM, Adam Ruppe wrote: >> >> a) I really like a fixed width for the links, so it forms a neat >> grid. My eyes just see a blob of links when it's a list... > > That would really hurt e.g. set operation

Re: new documentation format for std.algorithm

"Andrei Alexandrescu" wrote in message news:iibuu1$123i$1...@digitalmars.com... > On 2/2/11 6:06 AM, Nick Sabalausky wrote: >> "Denis Koroskin"<2kor...@gmail.com> wrote in message >> news:op.vp9wmrreo7cclz@korden-pc... >>> On Wed, 02 Feb 2011 14:06:11 +0300, Magnus Lie Hetland >>> wrote: >>> >

Re: new documentation format for std.algorithm

On 02/02/2011 09:40 PM, "Jérôme M. Berger" wrote: Andrei Alexandrescu wrote: I'm not sure about that. Facebook's site is professionally designed and I think they use fixed font sizes all over the place. "Professionally designed" does not mean that they did the job right!

Re: new documentation format for std.algorithm

Andrei Alexandrescu wrote: > Following ideas and advice from this newsgroup, I have a draft at > > http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html > > There are two tables, one with just the names and the other with names > and a brief description. Let me know of any feed

Re: new documentation format for std.algorithm

Andrei Alexandrescu wrote: > > I'm not sure about that. Facebook's site is professionally designed and > I think they use fixed font sizes all over the place. > "Professionally designed" does not mean that they did the job right! Jerome -- mailto:jeber...@free.fr http://

Re: new documentation format for std.algorithm

On 2/2/11 2:15 PM, Magnus Lie Hetland wrote: On 2011-02-02 16:40:15 +0100, Andrei Alexandrescu said: On 2/2/11 5:06 AM, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80

Re: new documentation format for std.algorithm

On 2/2/11 2:16 PM, Magnus Lie Hetland wrote: On 2011-02-02 16:01:29 +0100, Andrej Mitrovic said: Yay! Glad to see this being incorporated in the website. Btw, about the fonts: I think this is a bug with the cutting-edge site only. The fonts appear bigger, but they'll end up being smaller on th

Re: new documentation format for std.algorithm

On 2011-02-02 16:01:29 +0100, Andrej Mitrovic said: Yay! Glad to see this being incorporated in the website. Btw, about the fonts: I think this is a bug with the cutting-edge site only. The fonts appear bigger, but they'll end up being smaller on the dmars website. See: http://i.imgur.com/7nfz

Re: new documentation format for std.algorithm

On 2011-02-02 16:40:15 +0100, Andrei Alexandrescu said: On 2/2/11 5:06 AM, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80 columns -- without starting a huge thread like

Re: new documentation format for std.algorithm

On 2/2/11 1:41 PM, Denis Koroskin wrote: On Wed, 02 Feb 2011 19:00:20 +0300, Andrei Alexandrescu wrote: On 2/2/11 7:07 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutti

Re: new documentation format for std.algorithm

On 2011-02-02 09:45, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me know

Re: new documentation format for std.algorithm

On 02/02/2011 08:41 PM, Denis Koroskin wrote: On Wed, 02 Feb 2011 19:00:20 +0300, Andrei Alexandrescu wrote: On 2/2/11 7:07 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/

Re: new documentation format for std.algorithm

On 02/02/2011 08:12 PM, Andrei Alexandrescu wrote: On 2/2/11 2:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the othe

Re: new documentation format for std.algorithm

On Wed, 02 Feb 2011 19:00:20 +0300, Andrei Alexandrescu wrote: On 2/2/11 7:07 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There

Re: new documentation format for std.algorithm

On Wed, 02 Feb 2011 20:12:07 +0100, Andrei Alexandrescu wrote: On 2/2/11 2:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the na

Re: new documentation format for std.algorithm

On Wed, 02 Feb 2011 19:00:20 +0300, Andrei Alexandrescu wrote: On 2/2/11 7:07 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There

Re: new documentation format for std.algorithm

On 2/2/11, Andrei Alexandrescu wrote: > * Added hyphenation, which should make justice to the justified style > (watch it at work in a narrow window!) It even copies text properly when there's a hyphen. Nice.

Re: new documentation format for std.algorithm

> Same principle may even be the default for > most modules, don't you think? Indeed. It also lets us automatically generate stuff off the existing files. Here's my first go at automated tables: http://arsdnet.net/d-web-site/std_algorithm2.html I only tagged the map function in the std.algorith

Re: new documentation format for std.algorithm

On 2/2/11 2:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me know of

Re: new documentation format for std.algorithm

On Wednesday, February 02, 2011 00:45:59 Andrei Alexandrescu wrote: > Following ideas and advice from this newsgroup, I have a draft at > > http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html > > There are two tables, one with just the names and the other with names > and a b

Re: new documentation format for std.algorithm

On 02/02/2011 05:05 PM, Daniel Gibson wrote: I don't understand why cmp, equal, isSorted, ... are in the "Mutations" category. what about an 'information' category? I use that word to categorise type functionality when there are numerous methods, seems to work fine. Typically '==', cmp, cont

Re: new documentation format for std.algorithm

On 02/02/2011 05:44 PM, Adam Ruppe wrote: I also moved the brief description from the table to the first line of the ddoc. The ddoc spec already describes the first paragraph as being a summary, with the following paragraphs as a separate description, so we

Re: new documentation format for std.algorithm

On 02/02/2011 05:00 PM, Andrei Alexandrescu wrote: On 2/2/11 7:07 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables,

Re: new documentation format for std.algorithm

On 02/02/2011 04:58 PM, Andrei Alexandrescu wrote: On 2/2/11 6:47 AM, spir wrote: On 02/02/2011 11:08 AM, bearophile wrote: BlazingWhitester: It looks realy nice! I agree, it's a clear improvement. But brief description table could use some spacing between descriptions. It's a lilttle ha

Re: new documentation format for std.algorithm

On 02/02/2011 04:55 PM, Andrei Alexandrescu wrote: I also agree with what others said about needing a better visual boundary between the different descriptions. I'll look into this. I saw arguments against alternating colors. Also, horizontal lines throughout would be ugly. Agreed. More id

Re: new documentation format for std.algorithm

Andrei Alexandrescu wrote: > For now it's manual; I had to write the actual text which was the bulk > anyway. Long term we'll need to look at generating the table by adding > category tags to each function/class etc. Right. I now think the best way to do it is something like this: Macros: WIKI =

Re: new documentation format for std.algorithm

On 2/2/11 10:05 AM, Daniel Gibson wrote: Am 02.02.2011 09:45, schrieb Andrei Alexandrescu: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with

Re: new documentation format for std.algorithm

Am 02.02.2011 17:22, schrieb Daniel Gibson: Am 02.02.2011 17:20, schrieb Andrei Alexandrescu: On 2/2/11 10:05 AM, Daniel Gibson wrote: Am 02.02.2011 09:45, schrieb Andrei Alexandrescu: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-

Re: new documentation format for std.algorithm

Am 02.02.2011 17:20, schrieb Andrei Alexandrescu: On 2/2/11 10:05 AM, Daniel Gibson wrote: Am 02.02.2011 09:45, schrieb Andrei Alexandrescu: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two

Re: new documentation format for std.algorithm

On 2/2/11 9:08 AM, Adam Ruppe wrote: Andrei Alexandrescu Wrote: There are two tables, one with just the names and the other with names and a brief description. Let me know of any feedback. Thanks! Did you decide on a manually maintained table or is it auto generated? I do really think adding

Re: new documentation format for std.algorithm

Am 02.02.2011 09:45, schrieb Andrei Alexandrescu: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me kno

Re: new documentation format for std.algorithm

On 2/2/11 10:06 AM, Adam Ruppe wrote: Andrei Alexandrescu: Hmmm, this wrong jumping is a problem. I'll look into it. Offhand I don't know how to distinguish in the generated doc between an enum value and a function, but Adam did it. Adam? My method is to track the level of nesting. The more t

Re: new documentation format for std.algorithm

Andrei Alexandrescu: > Hmmm, this wrong jumping is a problem. I'll look into it. Offhand I > don't know how to distinguish in the generated doc between an enum value > and a function, but Adam did it. Adam? My method is to track the level of nesting. The more tags above you in the tag tree, the f

Re: new documentation format for std.algorithm

On 2/2/11 7:07 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names an

Re: new documentation format for std.algorithm

On 2/2/11 8:34 AM, Simen kjaeraas wrote: Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief de

Re: new documentation format for std.algorithm

Andrei Alexandrescu wrote: On 2/2/11 8:34 AM, Simen kjaeraas wrote: Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the o

Re: new documentation format for std.algorithm

On 2/2/11 6:06 AM, Nick Sabalausky wrote: "Denis Koroskin"<2kor...@gmail.com> wrote in message news:op.vp9wmrreo7cclz@korden-pc... On Wed, 02 Feb 2011 14:06:11 +0300, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(i

Re: new documentation format for std.algorithm

On 2/2/11 6:40 AM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names an

Re: new documentation format for std.algorithm

On 2/2/11 7:00 AM, spir wrote: On 02/02/2011 12:24 PM, Denis Koroskin wrote: On Wed, 02 Feb 2011 14:06:11 +0300, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80 column

Re: new documentation format for std.algorithm

On 2/2/11 6:47 AM, spir wrote: On 02/02/2011 11:08 AM, bearophile wrote: BlazingWhitester: It looks realy nice! I agree, it's a clear improvement. But brief description table could use some spacing between descriptions. It's a lilttle hard to read. Instead of that I suggest to give an a

Re: new documentation format for std.algorithm

On 2/2/11 5:06 AM, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80 columns -- without starting a huge thread like that again ;) Yah, the irony! :o) For one thing, in n

Re: new documentation format for std.algorithm

On 2/2/11 4:00 AM, Dmitry Olshansky wrote: On 02.02.2011 11:45, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with

Re: new documentation format for std.algorithm

Andrei Alexandrescu Wrote: > There are two tables, one with just the names and the other with names > and a brief description. Let me know of any feedback. Thanks! Did you decide on a manually maintained table or is it auto generated? I do really think adding a Tags: section, or perhaps just pu

Re: new documentation format for std.algorithm

Yay! Glad to see this being incorporated in the website. Btw, about the fonts: I think this is a bug with the cutting-edge site only. The fonts appear bigger, but they'll end up being smaller on the dmars website. See: http://i.imgur.com/7nfzz.jpg

Re: new documentation format for std.algorithm

Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me know of any feedback.

Re: new documentation format for std.algorithm

On 02/02/2011 02:07 PM, spir wrote: On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with nam

Re: new documentation format for std.algorithm

On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me kn

Re: new documentation format for std.algorithm

On 02/02/2011 12:24 PM, Denis Koroskin wrote: On Wed, 02 Feb 2011 14:06:11 +0300, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80 columns -- without starting a huge th

Re: new documentation format for std.algorithm

On 02/02/2011 11:08 AM, bearophile wrote: BlazingWhitester: It looks realy nice! I agree, it's a clear improvement. But brief description table could use some spacing between descriptions. It's a lilttle hard to read. Instead of that I suggest to give an alternating white - light cyan ba

Re: new documentation format for std.algorithm

On 02/02/2011 09:45 AM, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me kn

Re: new documentation format for std.algorithm

"Denis Koroskin" <2kor...@gmail.com> wrote in message news:op.vp9wmrreo7cclz@korden-pc... > On Wed, 02 Feb 2011 14:06:11 +0300, Magnus Lie Hetland > wrote: > >> I think perhaps some adjustments could be made to the layout, to make it >> more suitable to narrow(ish) browser windows (c.f., the di

Re: new documentation format for std.algorithm

On Wed, 02 Feb 2011 14:06:11 +0300, Magnus Lie Hetland wrote: I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80 columns -- without starting a huge thread like that again ;) For one thing, in

Re: new documentation format for std.algorithm

I think perhaps some adjustments could be made to the layout, to make it more suitable to narrow(ish) browser windows (c.f., the discussio about 80 columns -- without starting a huge thread like that again ;) For one thing, in narrow(ish) columns, ragged-right might be preferable. Then again,

Re: new documentation format for std.algorithm

On 02.02.2011 11:45, Andrei Alexandrescu wrote: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me know

Re: new documentation format for std.algorithm

On 2011-02-02 10:45:59 +0200, Andrei Alexandrescu said: Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Le

new documentation format for std.algorithm

Following ideas and advice from this newsgroup, I have a draft at http://d-programming-language.org/cutting-edge/phobos/std_algorithm.html There are two tables, one with just the names and the other with names and a brief description. Let me know of any feedback. Thanks! Andrei