<message id="<4es4e4$31q@news-e2a.gnn.com>" date="3032224644" seqno="12431">
From: jmcarthur@gnn.com (Jeffrey McArthur)
Newsgroups: comp.text.sgml
Subject: Re: SGML conversion tools?
Date: 2 Feb 1996 04:37:24 GMT
Organization: Internet Squire
Message-ID: <4es4e4$31q@news-e2a.gnn.com>
References: <310D4CE9.32AF@mks.com>
Reply-To: JMcarthur@gnn.com

Viktor Haag (Mortice Kern Systems) wrote:
>We'd like to maintain single-source docs in DocBook, and provide
>presentations in printed, HTML and WinHelp(RTF) formats.

I would be very interrested in what you find.
----
    Jeffrey M\\kern-.05em\\raise.5ex\\hbox{\\b c}\\kern-.05emArthur
    a.k.a. Jeffrey McArthur          email: j_mcarthur@bix.com
    phone: (301) 306-5188                   JMcarthur@gnn.com
    home:  (410) 290-6935

The opinions expressed are mine.  They do not reflect the opinions
of my employer.  My access to the Internet is NOT paid for by my
employer. My access to the Internet is on my own time at my own
expense.
</message>
<message id="<4et921$8nr@Mercury.mcs.com>" date="3032262145" seqno="12433">
From: jorn@MCS.COM (Jorn Barger)
Newsgroups: comp.text.sgml
Subject: WWW-RANT: Biting the hand that gave us birth-- sorry TBL
Date: 2 Feb 1996 09:02:25 -0600
Organization: The Responsible Party
Message-ID: <4et921$8nr@Mercury.mcs.com>


[I think my first attempt to post this had munged Cc's.  Sorry if you
get multiples.]

[The point of this post is that there's much to be learned about
hypertext design *via the WWWeb*.  It doesn't matter at all that the
technology is simple.]

I've been reluctant to critique Tim Berners-Lee's WWWeb style guide at
\<URL:http://www.w3.org/pub/WWW/Provider/Style/>, because Tim invented
the WWWeb, and for that alone he should bask in glory, all his days...

But, all the same, his guide is seriously flawed, both in the design 
strategies it recommends, and the ones it embodies.  So here's a
brief list of what I see as its errors.

Far too often, Tim fails to take his own advice:

- Site not checked with lynx, navigation buttons lack ALT text thruout
- Multiple audiences mixed-- beginner and technical-- tech terms undefined
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Introduction.html> \&c
- Spellcheck needed thruout
- Broken HTML
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Testing.html> "client list"

- Links not carefully tested
  - Back button skips one file
\<URL:http://www.w3.org/pub/WWW/Provider/Style/ReaderStructure.html>
  - Next button skips several files
\<URL:http://www.w3.org/pub/WWW/Provider/Style/ReaderStructure.html>
  - File revised and relocated, but many links not updated!?!
\<URL:http://www.w3.org/pub/WWW/Provider/Etiquette.html> old
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Etiquette.html> new

- Inconsistent navigation buttons (so prevalent it seems intentional?)
  - A rare case of all buttons correctly in place
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Trees.html>
  - Button missing from all pages but one
\<URL:http://www.w3.org/pub/WWW/Provider/Style/TITLE.html> "markup"
  - [Prior] button at bottom not top of page-- thruout
  - No [Prior] button
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Etiquette.html>
\<URL:http://www.w3.org/pub/WWW/Provider/Style/IntoContext.html>
  - No [Next] button ('stairmaster fallacy')
\<URL:http://www.w3.org/pub/WWW/Provider/Etiquette.html>
\<URL:http://www.w3.org/pub/WWW/Provider/Style/ReferOrCopy.html>
\<URL:http://www.w3.org/pub/WWW/Provider/Style/NoMechanics.html>
  - Orphan page (no up-link)
\<URL:http://www.w3.org/pub/WWW/Provider/Etiquette.html>
\<URL:http://www.w3.org/pub/WWW/DesignIssues/Navigation.html>
  - Foster-orphan (uplink skips levels)
\<URL:http://www.w3.org/pub/WWW/Provider/Style/ReaderStructure.html>
\<URL:http://www.w3.org/pub/WWW/Provider/Style/DateIt.html>

- Misleading links
  - Disguised up-links
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Etiquette.html> "This Guide"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/WithinDocument.html>"style guide"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/IntoContext.html> \&c "Part of"
  - Unsignalled/confusing violations of tree-structure
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Introduction.html> miniToC at end
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Etiquette.html> "Signing""status"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/DeviceIndependent.html> "testing"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Testing.html> "make it clear"
  - Unclear whether link is #-link or separate doc
\<URL:http://www.w3.org/pub/WWW/Provider/Style/> all subheads in ToC
  - 'Junk links' to sites used as definitions of terms
\<URL:http://www.w3.org/pub/WWW/Provider/Style/> "WWW"
\<URL:http://www.w3.org/pub/WWW/People/Berners-Lee/>  many examples
  - Anchor text doesn't clearly explain contents of target page
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Etiquette.html> "rule file"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/DocSize.html> "next"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/ReferOrCopy.html> hotlist at end
\<URL:http://www.w3.org/pub/WWW/Provider/Style/ReadableText.html> "I'm" (#-link)
  - Anchor text trimmed excessively (the more self-explanatory the better)
\<URL:http://www.w3.org/pub/WWW/Provider/Style/IntoContext.html>
  "WWW" could be "WWW product documentation"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Printable.html>
  "single page" could be "single page version of the whole thing"
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Testing.html>
  "HTML overview" could be "the W3C HTML overview"
  - Live demo-links distracting
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Printable.html> "device ind."

- Wasted pages
  - Sub-ToCs waste reader's time
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Structure.html>
\<URL:http://www.w3.org/pub/WWW/Provider/Style/WithinDocument.html>
  - Too-short pages waste readers' time
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Virtual.html>
\<URL:http://www.w3.org/pub/WWW/Provider/Style/Footnote.html>
  - Undescriptive table of contents should *summarize* each 'chapter'
\<URL:http://www.w3.org/pub/WWW/Provider/Style/> [better than average]


The advice Tim offers is often topnotch, but occasionally very doubtful:

\<URL:http://www.w3.org/pub/WWW/Provider/Style/DocSize.html>
'One page per idea' is a bad idea with non-local latencies

\<URL:http://www.w3.org/pub/WWW/Provider/Style/Footnote.html>
'Footnotes a page each' is unworkable for the same reason.  Keep footnotes
on the same page.

\<URL:http://www.w3.org/pub/WWW/Provider/Style/DeviceIndependent.html>
'Use \<h?> headers in strict order' is too limiting.  Eg, subpages at least
ought to be allowed to start with \<h2>.

\<URL:http://www.w3.org/pub/WWW/Provider/Style/NoMechanics.html>
FTP and other non-HTTP links should be labelled so, in general.

\<URL:http://www.w3.org/pub/WWW/Provider/Style/Trees.html>
Sharing the same pages between expert and novice views is not usually a
real advantage.


j

-==---
. hypertext theory : artificial intelligence : finnegans wake . _+m"m+_"+_ 
              lynx http://www.mcs.net/~jorn/ !            Jp   Jp     qh qh
          ftp://ftp.mcs.net/mcsnet.users/jorn/            O    O       O  O
                news:alt.music.category-freak             Yb   Yb     dY dY
...do you ever feel your mind has started to erode?        "Y_  "Y5m2Y"  "  no.
</message>
<message id="<14808@tygra.Michigan.COM>" date="3032251593" seqno="12434">
From: rabbit@tygra.Michigan.COM (Roger Rabbit)
Newsgroups: comp.text.sgml
Subject: How to get The MORTIMER Story
Message-ID: <14808@tygra.Michigan.COM>
Date: 2 Feb 96 12:06:33 GMT
Organization: Shut Up Blair

This posting was made automatically by machine. It will appear once
every minute or so. Direct any questions to rabbit@Buster.Michigan.COM

-------

The MORTIMER story can be retreived from a special archive server
(the Mort-Server) To request a part of the MORTIMER  story,  send 
mail  to one  of  the  addresses  below.  Put   your  request  on 
the Subject: line of your message. Requests are can be the in the
following form:

    ALL - (in upper case) will cause the entire story to be sent
          to you. 

    n   - (where n is an integer) will cause part one to be sent

 n,m... - (where n and m, etc are integers) will cause parts n, m
          and so forth, to be sent.

You may send your request to any of the following addresses:

     MORTIMER@Buster.Michigan.COM
     MORTIMER@Babs.Michigan.COM
     MORTIMER@Plucky.Michigan.COM
     MORTIMER@Hamton.Michigan.COM
     MORTIMER@McLoon.Michigan.COM
     MORTIMER@Elmyra.Michigan.COM

If you send off a request and don't get a response within 5 days, 
send e-mail to the sysop here (NOT ME!!). His address is:

     ARCHIVER@Michigan.COM

-- 
>>> BAN: Nuclear Power, US Intervention in The Gulf, Toxic Waste,
>>> rdc, carasso, Trash Incinerators, Nuclear Weapons, Poverty, KiBoIsM
>>> Racism, Kent Paul Dolan, Specieism, etc... Write: Rabbits for a Better 
>>> Hutch, Roscommon, MI 48653 E-MAIL: rabbit@Buster.Michigan.COM
</message>
<message id="<4eth3k$eid@i-2000.com>" date="3032281595" seqno="12435">
From: censign@interserv.com (Chet Ensign)
Newsgroups: comp.text.sgml
Subject: ANNOUNCEMENT: SGML Open hosting open house at Seybold conference
Date: Fri, 02 Feb 1996 20:26:35 GMT
Organization: I-2000 Inc. - Internet Services
Message-ID: <4eth3k$eid@i-2000.com>

Visit the SGML Open House at Seybold Seminars Boston

The annual spring Seybold conference and exposition takes place at the
Hynes Convention Center, Boston, MA, on February 27 through March 1,
1996.  If you are going to the conference and/or expo and you have an
interest in SGML, you'll want to visit the SGML Open House.

The SGML Open House is an informal meeting place for Seybold attendees
who want more information about SGML and its application to today's
electronic publishing solutions. Attendees can share ideas with other
users, have their questions answered by SGML experts, collect
educational materials, and learn about new developments in SGML-based
technologies.

The SGML Open House is sponsored and staffed by the members of SGML
Open, the international consortium of suppliers whose products and
services support SGML. The Open House, scheduled for Wednesday and
Thursday, February 28 and 29 from 10:00 am to 6:00 pm, is located in
Room 102a at the Hynes Convention Center. 

Refreshments will be provided by SGML Open sponsor member companies
ArborText, Inc., XSoft, Data Conversion Laboratory, and the Graphic
Communications Association. 

Chet Ensign
Chairperson, External Communications Committee 
SGML Open 



</message>
<message id="<4eu6ab$kd1@senator-bedfellow.MIT.EDU>" date="3032292107" seqno="12438">
From: timbl@w3.org (Tim Berners-Lee)
Newsgroups: comp.text.sgml
Subject: Re: WWW-RANT: Biting the hand that gave us birth-- sorry TBL
Date: 2 Feb 1996 23:21:47 GMT
Organization: Massachvsetts Institvte of Technology
Message-ID: <4eu6ab$kd1@senator-bedfellow.MIT.EDU>
References: <4et921$8nr@Mercury.mcs.com>
Reply-To: timbl@w3.org

In article <4et921$8nr@Mercury.mcs.com> jorn@MCS.COM (Jorn Barger) writes:

> 
> I've been reluctant to critique Tim Berners-Lee's WWWeb style guide at
> \<URL:http://www.w3.org/pub/WWW/Provider/Style/>, because Tim invented
> the WWWeb, and for that alone he should bask in glory, all his days...

Well, that's very nice of you, but for goodness' sake don't worry
about tearing my ideas of style to pieces.  Reluctance is *not* called
for. I haven't had much time
to revisit the guide.  I think many of your criticisms are very
accurate.  If I have time I'll revise it.

The only things in your comments I am not sure about are the
those resenting wasting reader's time with small documents,
like footnotes.  There is clearly a differnt style which one
needs in a 28.8 environment with one Netscape wondow compared
with a fast multiwindow environment.  The orginal WWW program
opened a new window, unadorned, by default (very quickly, much
faster than a typeical clone function).  When you have fast
access and easy retreat, (like for example a definition
in Microsoft Help) you can afford to do different things.
If I had time which I don't right now :-( I would discuss the
differences in style with browser style and net speed.
I'll keep your comments in the guide anyway.  Thank you for them!

(I imagine and hope that thoughts on style have come a long
way since that guide, but I do get quite a lot of +ive feeedback
about it too ;-)

Tim

___________________________________________________________
Tim Berners-Lee	                    Director, W3 Consortium
MIT Laboratory for Computer Science Phone +1 (617) 253 5702
545 Technology Square               Fax   +1 (617) 258 8682
Cambridge MA 02139, USA             Email      timbl@w3.org
http://www.w3.org/People/Berners-Lee
</message>
<message id="<Bernstein-0202961819300001@slip-6-15.shore.net>" date="3032291970" seqno="12439">
From: Bernstein@eastgate.com (Mark Bernstein)
Newsgroups: comp.text.sgml,alt.hypertext
Subject: Re: Hypertext Theories
Date: Fri, 02 Feb 1996 18:19:30 -0500
Organization: Eastgate Systems, Inc.
Message-ID: \<Bernstein-0202961819300001@slip-6-15.shore.net>
References: <9601300135.AA15133@fly.hiwaay.net> <4ek508$igd@Venus.mcs.com> <9601311617.AA22637@fly.hiwaay.net> <4eojl1$38s@Mercury.mcs.com> <9602010548.AA27472@fly.HiWAAY.net>

In article <9602010548.AA27472@fly.HiWAAY.net>, Len Bullard
\<cbullard@HiWAAY.net> wrote:

> We know how to write DTDs.  We need an SGML system that is property-based
> for assignment of multiple semantics. 

Len -- was your choice of the indefinite article, "_an_ SGML system", an
accident? Or does it mean that you might be open to a redefinition of SGML
or to a new standard, generalized markup language?

I confess that I've never understood the technical reason that a
generalized markup language could not be devised to be, say, LR(1). Were
SGML less difficult to parse, or more amenable to the use of compiler
generators, I'm sure that this debate would be less violent.  Could it, in
principle, be done?
-- 
Mark Bernstein               Bernstein@eastgate.com
Eastgate Systems, Inc        voice: (800) 562-1638 +1 (617) 924-9044
134 Main Street              fax:   (617) 924-9051
Watertown MA 02172 USA       http://www.eastgate.com/
</message>
<message id="<DM5qzy.8D8@news.hawaii.edu>" date="3032268910" seqno="12440">
Newsgroups: comp.text.sgml
From: pollarda@Hawaii.Edu (Art Pollard)
Subject: SGML Style Sheets
Message-ID: \<DM5qzy.8D8@news.hawaii.edu>
Sender: news@news.hawaii.edu
Organization: University of Hawaii
Date: Fri, 2 Feb 1996 16:55:10 GMT


I am looking for information on the new style sheet standard for SGML.
Where might I look to find additional information on it?  Also, how 
robust is it?  (I.e., can I duplicate all the text display fuctionality in 
WordPerfect with such a style sheet -- assuming the display engine can do 
it?  

Any information would be more than helpful.

Thanks,

-Art


</message>
<message id="<xEq7GMDBaez8@bionic06.bionic.zerberus.de>" date="3032289574" seqno="12446">
Newsgroups: comp.text.sgml
Message-ID: \<xEq7GMDBaez8@bionic06.bionic.zerberus.de>
From: ST.KURTZ@BIONIC.zerberus.de (Stefan Kurtz)
Organization: FoeBuD e.V. - Billyfield
Subject: TEI & SQ's Author/Editor
Date: Fri, 02 Feb 1996 23:39:34 +0100

Hello,
 I want to use SoftQuads Author/Editor with the TEI-dtds. I tried many
 times - but I never had success. Rulesbuilder failed with some
 "entities missing" etc. messages. The other people from our project
 did'nt manage it too. Well, there are no entity-files missing, we
 tried with different distributions. Rumours from the net say, that
 it is in fact impossible to use TEI with A/E - is this true or not?

Clueless,
Stefan.

--
"....Virtue is more to be feared than vice, because its excesses are not
 subject to the regulation of conscience."	--Adam Smith

    st.kurtz@bionic.zerberus.de      <>     stkurtz@coli.uni-bielefeld.de
	             http://www.uni-bielefeld.de.de/~stkurtz/
</message>
