Re: [Freeciv-Dev] Second Try at New Manual

[Greg Wooledge <wooledge@xxxxxxxxxxx>]

David King (crkinger@xxxxxxx) wrote:

> The second installment of my Freeciv documentation project is ready
> for internal review.  I have uploaded to
> ftp.freeciv.org/pub/incoming a bzip2'd tar file of a new Freeciv
> User's Manual, containing a Server Guide and a massive Client Guide.

I'm using the copy which was sent out on the mailing list (since it's
already here...).  I didn't actually read every word of it; I just
skimmed through it.

Overall:
  Instructions that the player must follow in order to stay in sync with
    the tutorial should be highlighted somehow -- it's easy to lose one's
    place and miss an instruction, especially if the web browser is on a
    different virtual desktop from the Freeciv client.

client-2.html:
  Avoid the first person (Delete this sentence: "I just wanted to...").
  Perhaps put a picture of the pulldown menu.  (Tough to get a screenshot
    of it?)
  "At this point the city is too small to permit specialists." -- This is
    not correct.  It's too small for specialists other than entertainers.

client-3.html:
  "... try to find the Greek cities.  Move your Explorer one square to
    the east; ...."  At this point the Explorer is already next to an
    Ocean square on the east, so he can't be moved east.

client-4.html:
  2.1.11 -- Explain the asterisk.
  2.1.14 -- Might be more effective if you actually took a screen shot
    from a game with some wonders.
  2.1.16 -- Explain the asterisks.

client-5.html:
  The "Rates Window", "Players window", etc., should be links.
  xv will read the xpm files (though it's non-free software).

client-6.html:
  The Next link points to client-7.html which does not exist.

-- 
Greg Wooledge                    | Distributed.NET http://www.distributed.net/
wooledge@xxxxxxxxxxx             | because a CPU is a terrible thing to waste.
http://www.kellnet.com/wooledge/ |