On 2025.12.11 10:46, Tom Russo wrote:
Xastir's documentation is a bit, um, fragmented? We have READMEs of
various
vintages, we've got a wiki that is sometimes (but not often) kept
up-to-date.
I am starting to look into revamping more of our documentation,
starting
with README.MAPS (which is very, very outdated and not at all a good
resource for first time users). I have to decide whether to rewrite
the
whole file or pitch it and just do the documentation on the wiki. We
already have a "HowTo:MAPS" wiki page which is a subset of README.MAPS
and
almost as out of date. I don't want to have to maintain TWO
documentation
sets, as keeping them synced is a maintenance headache.
So, of you remaining Xastir users, what would you prefer to look at:
README
files or a wiki, or something else?
And if you can imagine yourself being a first-time Xastir user, what
would
you prefer to be told to do when you have to learn how to do something
for
the first time:
"go look at our wiki on page xxxxx" or "go read the file README.XXX" or
something else?
And while I'm at it: "do you actually use Xastir anymore?"
I've a new-to-me box that is hoping for Xastir this winter. While I've
been here since the beginning I'm easily a beginner. I think a Wiki
might be the most useful.
Last wknd I ended up with an unplanned dive into the docs for N1MM+. I
was only looking for one thing, however the docs proved so good that I
kept going, a learning.
So, "go look at our wiki on page xxxxx" would like work for me.
HyperText is truly a wonderful thing.
Thanks to the shakers here.
Cheers, John
--
John D Erskine
VE7MHI VA7OTC
CN88hk NA-036
Victoria, B.C.
_______________________________________________
Xastir mailing list
[email protected]
http://xastir.org/mailman/listinfo/xastir
