Discussion
Loading...

Post

  • About
  • Code of conduct
  • Privacy
  • Users
  • Instances
  • About Bonfire
Paolo Amoroso
@amoroso@oldbytes.space  ·  activity timestamp 7 days 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@oldbytes.space replied  ·  activity timestamp 6 days ago

@amoroso I definitely need to look that one up

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

@arclight Glad it's useful.

  • Copy link
  • Flag this comment
  • Block
arclight
@arclight@oldbytes.space replied  ·  activity timestamp 6 days 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
@amoroso@oldbytes.space replied  ·  activity timestamp 6 days 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
@hisdeedsaredust@mastodon.online replied  ·  activity timestamp 6 days 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
@amoroso@oldbytes.space replied  ·  activity timestamp 6 days ago

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

  • Copy link
  • Flag this comment
  • Block
Log in

bonfire.cafe

A space for Bonfire maintainers and contributors to communicate

bonfire.cafe: About · Code of conduct · Privacy · Users · Instances
Bonfire social · 1.0.0-rc.3.21 no JS en
Automatic federation enabled
  • Explore
  • About
  • Members
  • Code of Conduct
Home
Login