Velocity Reviews - Computer Hardware Reviews

Velocity Reviews > Newsgroups > Programming > HTML > Frames for documentation

Reply
Thread Tools

Frames for documentation

 
 
Robert Jones
Guest
Posts: n/a
 
      01-12-2005
Personally I find that properly coded frames work well for
documentation(language specs, tutorials, manuals, user guides,...).

A good example is The D Programming Language documentation at
www.digitalmars.com/D/index.html which is included the the Digital Mars
D Compiler for download.

Frames provide easy navigation through the documentation. The above
documentation would be better if it provide a alternate means of
navigation though(browse it with Lynx 2.8.3 is is real *FUN* in that I
have to constantly switch focus from one frame to the other).

However, frames *SHOULD NOT* be used for general websites or any other
purpose *OUTSIDE* of providing 'textual information' and then only if it
is meant to be downloaded.(The owner of the above documentation, Walter
Bright, is usually too busy working on his compilers to do additional
work, easier for him to use the documentation online like that than to
write and maintain a different versions of the same material. We should
give him a break, right?)

Just airing my point of view on the matter. I know you all are going to
flame me for it but at least I'm more knowledgeable than Bullis

--
Robert Jones ()
rjones21.freeshell.org (being overhauled)
"Only search for the truth if you have the courage to accept it."
-unknown(I google for it later)
 
Reply With Quote
 
 
 
 
Travis Newbury
Guest
Posts: n/a
 
      01-12-2005
Robert Jones wrote:

> Just airing my point of view on the matter. I know you all are going to
> flame me for it but at least I'm more knowledgeable than Bullis


Man that was the most blatentt attempt at trolling I have ever seen.

--
-=tn=-
 
Reply With Quote
 
 
 
 
Leif K-Brooks
Guest
Posts: n/a
 
      01-12-2005
Robert Jones wrote:
> Personally I find that properly coded frames work well for
> documentation(language specs, tutorials, manuals, user guides,...).
>
> A good example is The D Programming Language documentation at
> www.digitalmars.com/D/index.html which is included the the Digital Mars
> D Compiler for download.


Great. So when someone asks a question about D, how is anyone supposed
to send them a link to the relevant documentation?
 
Reply With Quote
 
Travis Newbury
Guest
Posts: n/a
 
      01-12-2005
Leif K-Brooks wrote:
>> Personally I find that properly coded frames work well for
>> documentation(language specs, tutorials, manuals, user guides,...).
>> A good example is The D Programming Language documentation at
>> www.digitalmars.com/D/index.html which is included the the Digital
>> Mars D Compiler for download.

> Great. So when someone asks a question about D, how is anyone supposed
> to send them a link to the relevant documentation?


QUICK Set the hook! Set the hook!


--
-=tn=-
 
Reply With Quote
 
Duende
Guest
Posts: n/a
 
      01-13-2005
While sitting in a puddle Leif K-Brooks scribbled in the mud:

> Great. So when someone asks a question about D, how is anyone supposed
> to send them a link to the relevant documentation?


Just post it here. I'll find it.

--
D?
http://wipkip.biz just to raise my PR
 
Reply With Quote
 
jake
Guest
Posts: n/a
 
      01-13-2005
In message <>, Leif K-Brooks
<> writes
>Robert Jones wrote:
>> Personally I find that properly coded frames work well for
>>documentation(language specs, tutorials, manuals, user guides,...).
>> A good example is The D Programming Language documentation at
>>www.digitalmars.com/D/index.html which is included the the Digital
>>Mars D Compiler for download.

>
>Great. So when someone asks a question about D, how is anyone supposed
>to send them a link to the relevant documentation?



"...just go to www.digitalmars.com/d and look at 'pragmas' .....".

Not that difficult, is it?

regards.
--
Jake

 
Reply With Quote
 
Steve Pugh
Guest
Posts: n/a
 
      01-13-2005
jake <> wrote:

>In message <>, Leif K-Brooks
><> writes
>>Robert Jones wrote:
>>> Personally I find that properly coded frames work well for
>>>documentation(language specs, tutorials, manuals, user guides,...).
>>> A good example is The D Programming Language documentation at
>>>www.digitalmars.com/D/index.html which is included the the Digital
>>>Mars D Compiler for download.

>>
>>Great. So when someone asks a question about D, how is anyone supposed
>>to send them a link to the relevant documentation?

>
>
>"...just go to www.digitalmars.com/d and look at 'pragmas' .....".
>
>Not that difficult, is it?


But "just go to http://www.digitalmars.com/d/pragma.html" is even
easier.

Steve

 
Reply With Quote
 
Brendan Taylor
Guest
Posts: n/a
 
      01-13-2005
On Thu, 13 Jan 2005 08:58:49 +0000, jake wrote:

> "...just go to www.digitalmars.com/d and look at 'pragmas' .....".


Doesn't having to do that defeat the purpose of a hypertext markup
language (and the web in general)?
 
Reply With Quote
 
jake
Guest
Posts: n/a
 
      01-13-2005
In message <cjrFd.66607$Xk.39839@pd7tw3no>, Brendan Taylor
<> writes
>On Thu, 13 Jan 2005 08:58:49 +0000, jake wrote:
>
>> "...just go to www.digitalmars.com/d and look at 'pragmas' .....".

>
>Doesn't having to do that defeat the purpose of a hypertext markup
>language (and the web in general)?


Sure. That's always a complaint that (some) people have against the use
of frames.

I guess it depends on whether you want to oppose frames from an
ideological standpoint, or whether you can accept that for some
(limited) applications, frames is just the best way to go.

www.digitalmars.com/d seems quite a good example of well written framed
content (although I'd make one small change -- getting the word 'index'
into the <title> of the index page).

regards.

--
Jake

 
Reply With Quote
 
jake
Guest
Posts: n/a
 
      01-13-2005
In message <>, Steve Pugh
<> writes
>jake <> wrote:
>
>>In message <>, Leif K-Brooks
>><> writes
>>>Robert Jones wrote:
>>>> Personally I find that properly coded frames work well for
>>>>documentation(language specs, tutorials, manuals, user guides,...).
>>>> A good example is The D Programming Language documentation at
>>>>www.digitalmars.com/D/index.html which is included the the Digital
>>>>Mars D Compiler for download.
>>>
>>>Great. So when someone asks a question about D, how is anyone supposed
>>>to send them a link to the relevant documentation?

>>
>>
>>"...just go to www.digitalmars.com/d and look at 'pragmas' .....".
>>
>>Not that difficult, is it?

>
>But "just go to http://www.digitalmars.com/d/pragma.html" is even
>easier.
>
> Steve
>

Indeed it is.

And the nice designer has thoughtfully provided a link on each content
page so that the user can find his/her way back to the frameset page if
s/he wants to have a look at anything else that's listed in the index.

regards.

--
Jake

 
Reply With Quote
 
 
 
Reply

Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
converting XSD documentation to HTML documentation kev.sully@gmail.com XML 1 09-16-2006 12:09 PM
Link needed to go from a non-frames page to a Frames page, and load a particular frame. How? - Newbe Philip HTML 3 06-28-2004 03:06 PM
Python documentation: How about structured documentation? Looking for comments/suggestions Kenneth McDonald Python 2 05-06-2004 04:11 AM
Principles of documentation (was: Python Documentation Blows!) Cameron Laird Python 1 04-03-2004 06:54 PM
From Frames to no frames? Powerslave2112 HTML 2 01-20-2004 10:30 PM



Advertisments
 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57