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

[edodd at billiau.net]

On Sat, 3 Jan 2026 14:01:36 -0700
Tom Russo <russo at bogodyn.org> wrote:

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


I've written a few bits.
The old wiki didn't seem to have a clear backbone, and multiple
categories appeared under the "HowTo" section, ranging from Linux tips
through how to set up one's radio hardware through to clearly Xastir
topics like maps and dbfawk.

I am in favour of a clear backbone of major topics which are in a
sidebar for navigation and a full list of other pages.

There are many pages with abbreviations in their titles. I understand
most of them, but couldn't identify CS, SB and WMS.
Are there any other abbreviations in *page names* which people would
prefer written out in full?


Liz
VK2XSE