Discussion
Loading...

Post

Log in
  • About
  • Code of conduct
  • Privacy
  • Users
  • Instances
  • About Bonfire
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space  ·  activity timestamp 3 months ago

The Interlisp documentation has a distinctive style that conforms to "Xerox Publishing Standards: A Manual of Style and Design" published in 1988 in this edition. It was the Xerox house style, i.e. the style guide for company publications and documents. The manual covered everything from the publishing process to visual design.

https://www.janvwhite.org/xerox-publishing-standards

#xerox #interlisp #publishing #retrocomputing

  • Copy link
  • Flag this post
  • Block
arclight
arclight
@arclight@oldbytes.space replied  ·  activity timestamp 3 months ago

@amoroso I definitely need to look that one up

  • Copy link
  • Flag this comment
  • Block
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space replied  ·  activity timestamp 3 months ago

@arclight Glad it's useful.

  • Copy link
  • Flag this comment
  • Block
arclight
arclight
@arclight@oldbytes.space replied  ·  activity timestamp 3 months ago

@amoroso I keep kicking around writing a book on legacy code and it would just make sense to use a legacy style guide to subtly show what we've lost.

  • Copy link
  • Flag this comment
  • Block
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space replied  ·  activity timestamp 3 months ago

@arclight Looks like a good match. In case you're interested the DEC style guide and technical writing handbook are available too.

http://www.bitsavers.org/pdf/dec/_Books/_Digital_Press/Schultz_The_Digital_Style_Guide_1992.pdf

http://www.bitsavers.org/pdf/dec/_Books/_Digital_Press/Schultz_The_Digital_Technical_Documentation_Handbook_1992.pdf

  • Copy link
  • Flag this comment
  • Block
Paul Flo Williams
Paul Flo Williams
@hisdeedsaredust@mastodon.online replied  ·  activity timestamp 3 months ago

@amoroso I still have this on my shelves. I thought it was the epitome of style at the time.

  • Copy link
  • Flag this comment
  • Block
Paolo Amoroso
Paolo Amoroso
@amoroso@oldbytes.space replied  ·  activity timestamp 3 months ago

@hisdeedsaredust The old documents that conform to the manual are timeless and elegant.

  • Copy link
  • Flag this comment
  • Block

bonfire.cafe

A space for Bonfire maintainers and contributors to communicate

bonfire.cafe: About · Code of conduct · Privacy · Users · Instances
Bonfire social · 1.0.1 no JS en
Automatic federation enabled
Log in
  • Explore
  • About
  • Members
  • Code of Conduct