digitalmars.D - Why I'm hesitating to switch to D
-
James Fisher
(87/87)
Jun 28 2011
I'm a casual follower of development on D. In my opinion, it's the
-
David Gileadi
(9/13)
Jun 28 2011
I've done a little web design too, although it's definitely not my
-
Walter Bright
(17/17)
Jun 28 2011
Thanks for taking the time to do a detailed writeup on your opinions. I ...
-
James Fisher
(24/38)
Jun 28 2011
Well, thanks!
-
Trass3r
(8/18)
Jun 28 2011
Well the problem has indeed been solved in D2 by splitting the runtime
-
Jimmy Cao
(14/17)
Jun 28 2011
The tango homepage will never say something like, "D1/Tango is dead,
-
Nick Sabalausky
(5/31)
Jun 28 2011
And even if Tango does get ported to D2 (As I've heard some people are
-
Jacob Carlborg
(5/7)
Jun 28 2011
I think it makes it hard when most of the pages are written in DDOC. It
-
Walter Bright
(12/14)
Jun 29 2011
I have no idea what professional web designers use, but I did many web p...
-
James Fisher
(25/41)
Jun 29 2011
I agree that HTML isn't great to work with directly. Even in the realm ...
-
Nick Sabalausky
(4/12)
Jun 29 2011
Popularity should *never* be a significant concern. That's how we end up...
-
Adam Richardson
(4/20)
Jun 29 2011
Easy :) While I wouldn't use PHP for systems programming, PHP is a solid
-
Nick Sabalausky
(7/29)
Jun 29 2011
It's complete garbage for building websites. It's complete garbage for
-
Nick Sabalausky
(3/36)
Jun 29 2011
And there isn't a single damn thing about PHP that's remotely "stable".
-
Andrej Mitrovic
(12/12)
Jun 29 2011
I would agree that macros are a bit hard to read in ddoc. There's some
-
Jacob Carlborg
(4/16)
Jun 29 2011
Having XML in comments/documentation like that is just ridicules.
-
Jacob Carlborg
(5/37)
Jun 29 2011
I wouldn't completely agree with that. I hate PHP as well but I would
-
Nick Sabalausky
(5/45)
Jun 30 2011
Well, to be fair, if I had to choose between PHP and Classic ASP/VBScrip...
-
Jacob Carlborg
(4/51)
Jun 30 2011
A brick wall actually sounds better :)
-
Adam Richardson
(17/28)
Jun 29 2011
HTML is a fantastic for crafting web pages (and many web developers have
-
Walter Bright
(4/9)
Jun 29 2011
Anything you can do in HTML, you can do in Ddoc.
-
Robert Clipsham
(41/45)
Jun 29 2011
DDoc vs Markdown:
-
Walter Bright
(16/54)
Jun 29 2011
It was deliberately designed so you didn't actually have to know it in o...
-
Robert Clipsham
(14/78)
Jun 29 2011
I'm just glad it ditched the horrible @params: etc nonsense that every
-
Walter Bright
(6/22)
Jun 29 2011
That came from Javadoc. Yes, I hated it, too. I wanted the Ddoc function...
-
Adam Ruppe
(5/5)
Jun 29 2011
One thing I like about ddoc is how hands-off it is. You can put
-
Walter Bright
(3/6)
Jun 29 2011
The more special characters in the markup language, the more trouble you...
-
Andrei Alexandrescu
(7/13)
Jul 02 2011
One good thing about ddoc is its uniformity, $(name comma-sep-list) is
-
Adam D. Ruppe
(6/7)
Jul 02 2011
I don't know, it seems ok the way it is. The sections aren't quite
-
Nick Sabalausky
(11/19)
Jun 29 2011
I've used things like markdown and wiki...umm...that other markup with
-
Lutger Blijdestijn
(13/27)
Jul 01 2011
Sure, but it's really apples and oranges. Any such template system for
-
Adam Richardson
(26/34)
Jun 29 2011
I'm a web developer by trade, and ddoc, while nice for generating
-
Adam Ruppe
(8/11)
Jun 29 2011
That's how the D website works, in practice.
-
Walter Bright
(3/6)
Jun 29 2011
Of course not, but I've seen some markup systems that if you wanted some...
-
Jacob Carlborg
(10/26)
Jun 29 2011
That *is* awful. I use Ruby on Rails with the following languages (and
-
Walter Bright
(4/11)
Jun 29 2011
Are you recommending that people who want to contribute to D documentati...
-
Jacob Carlborg
(12/26)
Jun 29 2011
Your saying you don't know that language(s) web developers use, I'm
-
Nick Sabalausky
(9/25)
Jun 29 2011
I wouldn't mind switching to some "compile down to HTML/CSS/etc" thing, ...
-
Jacob Carlborg
(10/39)
Jun 29 2011
All of the above languages (except Ruby) use indentation for scopes.
-
James Fisher
(23/29)
Jun 29 2011
I'd definitely agree with that. I have no experience with DDOC, but TBH...
-
Walter Bright
(21/25)
Jun 29 2011
I do. Ddoc is:
-
James Fisher
(12/29)
Jun 29 2011
OK. These are all good reasons to maintain code documentation in Ddoc -...
-
Jacob Carlborg
(4/15)
Jun 29 2011
I completely agree with this.
-
Walter Bright
(3/11)
Jun 29 2011
Ok, so take lex.dd (or another page, pick any) and show how it is so muc...
-
KennyTM~
(18/35)
Jun 29 2011
Ddoc:
-
Andrej Mitrovic
(4/5)
Jun 29 2011
Hey it's the good old Python docs! :)
-
Andrej Mitrovic
(1/1)
Jun 29 2011
Vim can syntax highlight rest syntax, that's really sweet.
-
bearophile
(4/7)
Jun 29 2011
Yes, Sphinx is nice. Some Python tools are nice. I think I have suggeste...
-
Walter Bright
(25/36)
Jun 29 2011
In Ddoc, you can define your own macros to do that, for example:
-
KennyTM~
(56/99)
Jun 30 2011
Right, it's possible, but it is ugly. Isn't the point to show the syntax...
-
Walter Bright
(62/106)
Jun 30 2011
What's natural about that?
-
KennyTM~
(30/157)
Jun 30 2011
The 'foo' is still here. By natural I mean once you have a 'bar', you
-
Walter Bright
(27/47)
Jun 30 2011
Right, but defining your own macros is completely trivial, and when usin...
-
KennyTM~
(13/69)
Jun 30 2011
Right. Perhaps d-p-l.org should replace those $(LINK2 x#y, z) by
-
Walter Bright
(45/46)
Jun 30 2011
Take a look at this:
-
bearophile
(5/9)
Jun 30 2011
Sphinx is kind of new, but it's used for Python docs and elsewhere. Sphi...
-
KennyTM~
(21/68)
Jun 30 2011
Right. I agree this is one disadvantage in authoring the document.
-
Adam Ruppe
(32/38)
Jun 30 2011
Note that textual macros can do a *lot* better than this. If we
-
KennyTM~
(5/44)
Jun 30 2011
Interesting trick! Thanks. Indeed the default DDoc macros are not very
-
Walter Bright
(2/6)
Jun 30 2011
I wanted the default macros to not rely on having a style sheet.
-
KennyTM~
(2/10)
Jun 30 2011
The default $(DDOC) could have an embedded
