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 <[email protected]> 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 > [email protected] > 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] _______________________________________________ Xastir mailing list [email protected] http://xastir.org/mailman/listinfo/xastir
