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

[Tom Russo]

I have been hard at work trying to build out the Github wiki to be a more 
readable and up-to-date set of Xastir documentation, since xastir.org has been
dicey of late, and the in-source READMEs are very out of date.

It's coming along, but it is still a work in progress, but I am keen to 
have feedback and suggestions.  I'm also keen to have help.

Please go to https://github.com/Xastir/Xastir/wiki and take a look.  
Constructive criticism very welcome.

On Thu, Dec 11, 2025 at 11:46:25AM -0700, we recorded a bogon-computron collision of the <russo at bogodyn.org> flavor, containing:
> 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]
> 
> _______________________________________________
> Xastir mailing list
> Xastir at lists.xastir.org
> http://xastir.org/mailman/listinfo/xastir

-- 
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]