[Xastir] Poll: how do you like your documentation served up?

Tom Russo russo at bogodyn.org
Thu Dec 11 10:46:25 PST 2025


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?"

-- 
Tom Russo    KM5VY
Tijeras, NM  

 echo "prpv_a'rfg_cnf_har_cvcr" | sed -e 's/_/ /g' | tr [a-m][n-z] [n-z][a-m]



More information about the Xastir mailing list