
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>

<head>


<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">

</head>

<body text="#000000" bgcolor="#ffffff">

<font face="Helvetica, Arial, sans-serif">Hello Everyone - <br>

<br>

How do we handle different software versions when writing Floss

manuals? By versions I mean by platform and by numbered release. <br>

<br>

I can think of a few ways to do this:<br>

</font>

<ol>

  <li><font face="Helvetica, Arial, sans-serif">Create a new manual for

each version. For example, </font>Firefox 3.x and Firefox 4.x would

have separate manuals. <br>

  </li>

  <li>Incorporate all versions into a single manual by adding a chapter

that describes the differences.</li>

  <li>Incorporate all versions into a single manual by describing the

differences, where they exist, for each feature.</li>

</ol>

Suggestion 1 would result in multiple versions of guides that may share

a lot in common. This could cause extra maintenance work because a

change to guide A might have to be repeated in guide B. <br>

For suggestion 2, we would have chapters that might never be read. <br>

Suggestion 3 might work the best. If you are describing a feature, you

could describe how it works under Windows, Mac, and Linux. <br>

<br>

Any thoughts?<br>

<br>

Thanks,<br>

<br>

Mark<br>

</body>

</html>